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Lab 1 


IBM Software 


Applications and libraries 


1.1 Introduction 


WebSphere® Message Broker Version 8, the previous version of IBM® Integration Bus Version 9, 
introduced a new approach to the organization and development of applications, known as 
Applications and Libraries. 


This short document describes how Applications and Libraries are manifested, how they appear to 
the message flow developer, and how they will appear in the runtime environment, through the 
Integration Bus Explorer. 


Section 1.2 shows a simple example of the Applications and Libraries view, and how to 
create and deploy a new Application. 

Section 1.3 shows a simple example of a Library, how it relates to an Application, and how to 
manage Library References. 

Section 1.4 shows how to deal with projects that are not part of an application or library. 
Section 1.5 shows how to import an existing Message Broker project into a Version 9 
workspace and convert it to an application or library. 

Section 1.6 shows the changes made to the bar file editor to reflect the revised Applications 
and Libraries implementation. 


You will be able to run most of this lab with just the IBM Integration Bus Version 9 Toolkit, without the 
need for any additional materials. 
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1.2 Applications and libraries view 


1. | Click on the icon to start the IBM Integration Toolkit 9.0 (or use the Start menu). 


ae 


EM 
Integration 
Toolkit) 





2. Select the C:\student\AppsLibs\workspace workspace. 


select a workspace 


IBM Integration Toolkit stores your projects in a folder called a workspace. 








"| Use this as the default and do not ask again 





3. Press the OK button to continue. 
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__4. — Click on Go to the Integration Toolkit. 


| Welcome £3 





Al 
G to the Integration Toolkit f 
et Eo 


~ 


—L 
'd 


} 





| \ 
e. / co 
Get Started Samples Returning Users Web Resources 
Get started with IBM Explore IBM Integration Discover new features and View the latest information 
Integration Bus: create the sample applications learn how to migrate to IBM updates and discover 
Default Configuration, then Integration Bus Version 9.0 additional web resources 


verify your installation using 
the Pager samples 


After closing the Welcome Page in the Integration Toolkit, the starting page of a new workspace looks 
like this. 
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File — Edit — Navigate—Search Project Ran Window Help 
— eet eee eee 


mE Patterns Explorer | imi, 








Quick Starts 
| Application Development pad Start building your application with one of the following tasks, 


| New Application... 





New Integration Service... 
An Application is a container for all the resources that are required to 


New Library... create a solution. More... 





Start by creating an integration service 


An Integration Service is an application with a well-defined interface 
and structure. More... 


ii Start by creating a library 
A Library is a logical grouping of related code, data, or both. More... 





§¥ Start from WSDL and/or XSD files 





Use this task to create an Integration Service, Application or Library 
which includes your WSDL and/or ASD files. 


=|5r 


=) Start by discovering a service 
A Service allows you to invoke the remote system using discovered 
resources. 
oe, Start from patterns 
A Pattern is a reusable solution that encapsulates a tested approach to 
solving a common architecture, design, or deployment task. More... 
"| Start from samples 


Use the Samples to learn more about the features in IBM Integration 
Bus. More... 














[a Integration Nodes an M2 Data Source Explorer ~O | EF Properties a . [Bi Problems| g= Outline| 4) Tasks) FE Deployment Log ~ 0 

















The default starting point shows the “Application Development’ view. Note that there are no project 
options shown in the Application Development view. All Application or Library or Pattern artifacts will be 
presented as items under the Application Development view. 


__5. — Create a new Application by clicking Start by creating an application. 
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Name the new application TestApp1. 





ee 
CYNeW Application = - 


Create a new application 


An application is a deployable container that provides isolation at runtime. Enter a name for the new application. 


Application name ff TestAppl 


cy 


__7. — Press the Finish button. 
The new application should be visible in the project navigator. 
Application Development NeW. 
[=] Test4op1 
8 


__8. — Click the New... hot spot. 
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__9. Click Message Flow. 


New Artifact 

Create a new artifact. 
Els; Subflow 

[=F Message Model... 
[rt Message Map 

[A& ESOL File 

ce Decision Service 

fii Broker Schema 

ae Adapter Connection 
a Database Definition 


ae Data Lineage Documents 


__ 10. 


Create a new message flow 
Select a container for the new message flow 





Container: 
Message flow name: 
Flow organization 
Use default broker schema 


Schema: | (default broker schema) 








__11. Press the Finish button. 
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__12. Expand the WebSphere MQ folder. 


Application £2 ™. &e, Patterns Ex 


Application Development 


TestAppl 
2 Flows 
TestFlowL.msgflow 


| *TestFlowL.msgflow 23 
Sas” 
New... [* 4 Le = 


4 2 Palette 


La Favorites | 
(4 WebSphere MQ ao 
2") MOInput 










i? MQReply 
i, MQGet 
i) MQHeader 

[J MQOptimizedFlow (0... 

ams JMS il 
(a, HTTP 

La Web Services 

(o) SCA 

(gt: WebSphere Adapters 

> Routing 

(ret MET 


[re 


Graph | User Defined Properties 


=— 


__13. Drag an MQInput node to the message flow editor canvas. 


__14. Change the name to APPSLIBS.IN. 


__15. Inthe Properties pane select the Basic tab. 








Description 


Q we a _ me" 


Input Message Parsing 
Parser Options 

Advanced 

Validation 

Security 





fi Problems| G= Qutline| 44) Tasks| EE Deployment Log 


I MQ Input Node Properties - APPSLIBS.IN 


= 


Browse MQ Services... 





IBM Software 


__16. Set the Queue name to APPSLIBS.IN. Remember that Queue names are case sensitive. All 
queue names in the labs are upper case. 
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7. 


__ 18. 


Select the Input Message Parsing tab. 











Description 








Message domain 


Input Message Parsing 
Message model 





Parser Options 
Advanced Message 


Validation 





PRysical Format 


Use the drop down menu to select XMLNSC as the Message domain. 


__19. Select an MQOutput node. 


_ 20. 
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4 <2 Palette 
AG 

| Favorites 
US WebSphere Mo a 











i MQHeader 


IJ: MQOptimizedFlow (D.., 
ms IMS 


Lee) HTTP 


Drag it to the canvas to the right of the APPSLIBS.IN node. 
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__21. Change the name of the node to APPSLIBS.OUT. 


q <2 Palette 

VG = 

Lat Favorites 

US WebSphere MO ash 

(4) MoInput 

tl) MQOutput 

Qwcpeo 
8) Moet 

a ol 4PPSLIBS. TY OPPSLIBS, OUT 


i MOQHeader 








(2 MQOptimizedFlow (D... 


__ 22. Inthe Properties pane select the Basic tab. 
: PS \\ [5 Problems| £2] Deployment Log us 
cl) MQ Output Node Properties - APPSLIBS.OUT 


Description 


QUEUE manager nane | 
Advanced Queue name [[arpsuies.our] 


Request 


Validation 





Monitoring 


__23. Set the Queue name to APPSLIBS.OUT. 
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__24. Expand the Construction drawer. 


“| <2 Palette 
L Web Services z 
io) SCA 
(qj: WebSphere Adapters 
> Routing 
(ray «NET 


zy 
Transformation | 


APPSLIBS.IN 









ec Construction + Me 
[}> Input 






TryCatch 
EE FlowOrder 7 
Graph | User Defined Properties 


__ 25. Select a Trace node. 
__26. Place it between the other two nodes. 


27. Wire the Out terminal of the APPSLIBS.IN node to the In terminal of the Trace node. 


2 Palette 
Lag Web Services 7 
(2) SCA 
(gh WebSphere Adapters 
_+ Routing 
(rat -MET 
Transformation 


mi 


al 
APPSLIBS.OUT 


la 
APPSLIBS.IN 











4 Construction a 


[> Input 
| Output 


fic: Throw 
0] Trace 


__28. Write the Out terminal of the Trace node to the In terminal of the APPSLIBS.OUT node. 


__29. Select the Trace node. 
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__ 30. Inthe Properties pane select the Basic tab. 


—Prroperties | tnd \ EE: Problems | Problems | G3 Deployment Log) 


Trace Node Properties - Trace 





Description 
Destination 
Monitoring File path 
Pattern 





Message catalog | 


__31. Use the drop down menu to set the Destination to File. 
__ 32. Setthe File path to c:\temp\AppsLibs.txt. 
__33. Set the Pattern to the following: 


Root=${Root} 


The message flow is now complete. 





gflow £2 





| 4 Palette 
Ly Web Services 7 
‘Lah SCA 
(gi: WebSphere Adapters 
| > Routing 
i WE 
Unb NET 
[5 Transformation 
SS i] APPSLIBS.IN 


errreer tert eer tert eer tert eer tert eer tert ter tere Cer tert eer ere ter er reer reenry 


‘(File LU 



































__ 34. Save the message flow (Ctrl+S). hs 
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The application can now be deployed using drag and drop. 


__35. Select the TestApp1 application. 


Application Development New... 


4 |[A] TestAppl | 
F : Flows 


El TestFlowl.msgflow 








__36. Drag it to the default Integration Server. 


__ 37. Drop the TestApp1 application on the default Integration Server. 


After the deployment is complete the TestApp1 application should be visible in the Integration Nodes 


view. 





4 2 Integration Nodes 
4 |¢5] IBSNODE| 
» Ee Configurable Services 


r) fe, default 
4 &) TestAppl ha 


Fle] TestFlowl 


__ 38. Close the TestApp1 message flow. 





TestFlow1.msgflowg: fp. 
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Creating a library and library references 


IBM Software 


A library is a container where shared resources can be stored. Message models and common subflows 
are examples of shared resources that should be stored in libraries. Libraries can be used by more than 


one application. Applications can contain references to more than one library. 


Subflows stored in libraries can be replaced independently of applications. When a shared subflow is 
replaced it is replaced for all applications that are using the subflow. 


1. 


Click the New... button. 


Application £3 ~ &2, Patterns Ex ~ 


SAS” 
Application Development New... 
TestAppl New Artifact 
= io Message Flow 
el TestFlowl.msgflow 
Independent Resources Ei Subflow 
j= GeneratedBarFiles [=v Message Model... 


[rat Message Map 
[B& ESOL File 

ce Decision Service 
Wij MOQ Service 

Aj Database Service 


Quick Start 


Start by creating an application 
Start by creating an integration service 


i Start by creating a library 


ae Start from WSDL and/or ASD files 


ne Integration 24 (PE Data Source 


2 Integration Nodes “a 
A IBINODE =" Start by discovering a service 


co —= non = 


Select Start by creating a library from the menu. 
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__ 3. 


_& 


Set the Library name to TestLib1. 


| (@) New Library 
Create a new library 


name for the new library. 


A library allows re-usable artifacts to be grouped and managed together. Enter a =) 


Library name] TestLibl 


Press the Finish button to create the library. 





The new library should be visible in the project navigator. 


_ s: 
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Application Development 
B-[Al Testappl a 


|] Independent Resources 
+) GeneratedBarFiles 






Select the New... option under the TestLib1 library. 
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__6. Select Message Model from the menu. 


New Artifact 
Create a new artifact. 


Subflow 


Fe Message Map 
[5% ESOL File 

ce Decision Service 
Wii MOQ Service 

Aj Database Service 


Broker Schema 


ae Adapter Connection 
ia Database Definition 
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__7. Select the Other XML radio button. 


DT =a 


Create a new message model file 





Select the message model type or format 











AML data for use in Web Services. 
All other XML data. 


Text and binary 


(-) CSV text Comma Separated Values data, a delimited text format commonly used as an export 
format by spreadsheets and databases. 


() Record-oriented text Text data formats where delimited fields are grouped into records. 
() COBOL Data for COBOL programs 


Data for C programs 


() Other text or binary = All other text or binary data formats. 


Enterprise Information Systems 
Data from SAP systerns including IDoc and BAPI 
; Data from Siebel systerns 
() PeopleSoft Data from PeopleSoft 
() JD Edwards Data from JD Edwards systems 


az zz ey EE ky a 


_—_— 


Other 

(-) CORBA IDL Data from CORBA 

() Database record Records from relational databases 
() MIME Data for extended email format 
(-) IBM supplied Predefined data format 











__8. — Press the Next button to continue. 
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9. Select the | already have an XML schema file for my data radio button. 


DD New Hessg: No eae 
Other AML 


Choose how you would like to create your AML message model. 





Integration Bus can parse and serialize your AML documents without a message model, but requires a model if you 
want to validate the AML & correct. A message model also speeds up development of your integration applications 
by enabling ESQL content assist and graphical maps. 


() Create an XML schema file using an XML document as an example 
() Create an empty XML schema file, I will model my data using the XML schema editor 
() Create an XML schema by importing an XML DTD 


= 





__10. Press the Next button to continue. 
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__11. Make sure that the Application or Library is set to TestLib1. 


DT 


Create a new message model file from an AML schema file 





Identify the AML Schema file to import into the workspace 








Application or Library: 
Folder: 


AML Schema file: « Default is the imported file's name. Select one below.> 


() Select file from workspace: 


[Al TestAppl 
ei, TestLibl 
[e] Independent Resources 


@ Select file from outside workspace: 


Location 











__12. Select the Select file from outside workspace radio button. 


__13. Press the Browse... button. 
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__ 14. Navigate to the C:\student\AppsLibs\resources directory. 





_. * student + AppsLibs » resources — Pw fy | Search resources | 


Organize ¥ New folder 





fam 


vi Favorites Name Date modified 


MD Desktop | 9/9/2011 8:32 AM XML Schema File 
my Downloads 


“S) Recent Places 


Libraries 
[=| Documents 


al’ Music 
(=| Pictures 
ee Videos 


( Computer 
ES, Local Disk (C:) 
(2 Shared Folders (\ 7 ¢ 


Filename: Autolnsurance 





__15. Select the Autolnsurance.xsd schema file. 


__16. Press the Open button. 
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__17. Made sure the Location is filled in. 


[i Sew Nese Mod ne 


Create a new message model file from an AML schema file 


Identify the AML Schema file to import into the workspace 








Application or Library: | TestLibl = 


Folder: Browse. 


AML Schema file: Autolnsurance.xsd 


() Select file from workspace: 


[A] TestAppl 
=) TestLibl 
(7) Independent Resources 


z= 


(@) Select file from outside workspace: 








Next > 





__18. Press the Finish button to import the schema file into the library. 


The new message model should be visible in the library. 


4oplication Development Mew... 


)-[A) Testappt 

= TestLibt 

| Fl-(2S Schema Definitions 

fon (S| 4ukolnsurance, xsd 
Ele] Independent Resources 


ce Gener atedBarFiles 
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__19. The Schema editor will open. Close it. 


is Subolnsurance, xsd . 


A new sub flow will now be added to the library. 


_ 20. Select the TestLib1 library. 


Application Development New... 
> TestAppl 
4 BA Testlibl 
4 (= Scher New 
a = htt _ 
Lopy 


di Independe Paste 
» LS Genere Delete 
Move... 


Rename... 
__21. Press the right mouse button. 


__22. Select New>Subflow from the menu. 
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Message Flow 

[=F Message Model... 
i} Message Map 

[a ESQL File 

fi = Broker Schema 

fe Adapter Connection 
[J Database Definition 


IBM Software 
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__23. Make sure the Container is set to TestLib1. 


Create a new subflow 


Select a container for the new subflow 


Container: TestLibl = 
" Subflow name: § SubFlowl 


Flow organization 


(default broker scherna) 





__ 24. Enter SubFlow1 as the Subflow name. 


__25. Press the Finish button to create the new subflow. 
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The message flow editor will open automatically. The wizard will automatically populate the new subflow 
with an input and an output node. 


__26. Expand the Construction folder. 


4 $2 Palette 


Lg WebSphere Adapters a“ | ! 
+ Routin . , 

= =a Input ' Output 
(a -NET 


Transformation 





[ee — 
et FlowOrder 
(ei Passthrough 


Eley ResetContentDescriptor = 


__ 27. Select a Trace node and drag it to a location between the Input and Output nodes. 


__ 28. Wire the Out terminal of the Input node to the In terminal of the Trace node. 





‘| <2 Palette 
Ae 
Lat Favorites 

Ld WebSphere Ma 
ims M5 









}>- 





ay > t. ) 
Trace | } | Muroue 





__ 29. Wire the Out terminal of the Trace node to the In terminal of the Output node. 
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__ 30. Inthe Properties pane select the Basic tab. 
[E Properties |e: i Problems| G= Qutline| 42) Tasks| FE Deployment Log 


‘ Trace Node Properties - Trace 


Description 
Destination File 
Sa- as a  | 

Monitoring File path 


Pattern 





Message catalog 


Message number 3051 


__31. Select a Destination of File using the drop down list. 
__ 32. Set the File path to c:\temp\AppsLibs.txt. 


__ 33. Enter Root=${Root} as the Pattern. 


__34. Save the message flow (Ctrl+S). Ss 


__ 35. Close the message flow editor. 


(Gs SUBFlow 1 ssubtlow % 
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A library reference will now be added to the TestApp1 application. 


__ 36. Select the TestApp1 application. 















File Edit WNavic 








Manage included projects 














Focus on Application 


Convert to Library 
Export ASDs from Application 
Migrate 


Go Into 






Copy 


Paste 





__37. Press the right mouse button. 
__ 38. Select Manage Library references from the menu. 


__ 39. Select the TestLib1 check box. 


(i) Manage Library References . 


Check the libraries to be referenced. Any other libraries referenced 
from the checked library will also be included. Leaving a library 
unchecked will prevent the libraries from being included. 


BA TestLibl 


The following libraries will also be included as they are referenced 
by the checked libraries. 


_ 
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__40. Press the OK button to create the library reference. 


The library reference should now be visible in the TestApp1 application. 








Application Development 


4 \fR) References 

4 BA TestLibl 
» (. Schema Definitions 
a 2 Subflows 


SubFlow1.subflow 
F Independent Resources 
 [ GeneratedBarFiles 





__41. Click on the twistie to open up and see the references from TestLib1. 


_ Application Development 


F TestAppl 
a = Flows 
Eel TestFlowl.msgflow 
Ma fa] References 
4 BA TestLibl 
4 (= Schema Definitions 
4a £& http://www.example.org/ 
[Ss] AutoInsurance.xsd 


a 2 Subflows 
Ela SubFlowL.subflow 


Ba TestLibl 
[> Independent Resources 
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__42. Nowlet’s redeploy the TestApp1 application to the runtime. Select the TestApp1 application, 
and then drag and drop it to the default Integration Server. 


TF Applicatio £2. 82, Patternsex| ~ O 






ik 
Application Development New... 
4 [A] TestAppl | 


El TestFlowl.msgflow 
[] References 
4 BA TestLibl 
4 (=. Schema Definitions 
a £& http://www.example.org/ 
[Ss] AutoInsurance.xsd 
a —® Subflows 
SubFlow1.subflow 






(> Ze TistLibl 
Fs Infependent Resources 





1, Integratio Po \ WE Data Soure | 
# 2 





2 Integraflon Nodes 
A] IBS@IDE 

re, default 

&a] TestAppl 






__ 48. Once it is deployed, open the twistie on the TestApp1 application under the default Integration 
Server to see how the TesiLib1 library also gets deployed. 


x >», Fa Data Sourc” 





4 &2 Integration Nodes 
a <4] IBSNODE 

re, default 

Bs £3) TestAppl 





TestFlowl 
4 Bl TestLibl 
Autolnsurance 
SubFlowl 
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1.4 The independent resources view 


Not all Integration Bus projects need be part of an application and library. Integration Bus projects that 
are not part of an application or library are displayed as independent resources. 


__1. Select the Independent Resources folder. 







































| Application Development yerel Start building your application with one of the following tas 
| 
é TestAppl 
> Gs Flows Start by creating an application 
4 |B] References An Application is a container for all the resources that are 
> BA TestLibl create a solution. More... 
, = start by creating an integration service 
4 (| Independent Resources| ___ a _ nines 
> [= GeneratedBarFiles | New | i | 
Re eres Soma ae 
Convert To Application or Library | Ss a ee 
| Fy Project... 
Copy | 
—e ja, Data Analysis Project 
iz DICOM Input Node Configurable Service 
Delete | 
hive i) Medical Device Input Node Configurable Service 
VWIOVE La, — 
| | _——— | Healthcare Pattern Test 
Gin Integration #3 an: Dat Ezy | Import | Fy Example... 
| 2 Export... |] Other... Ctrl+N 

















| - 


__2. Press the right mouse button. 
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__3. Select New>Integration Project. 


No references to existing independent Integration projects are required. 


(>) New Integration Project — 


Create a new Integration project — 


An Integration project is used to store integration artifacts such as message flows. Enter a name for the new Integration project. | 


Project name: 


Project reference setting 
Select the existing projects to reference. Click Next to select libraries to reference. 
| = GeneratedBarFiles 





__4. — Enter Project as the Project name. 
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5. Press the Next button to continue. 


No library references are required. 


| Create a new Integration project 


Specify dependencies on other libraries. 


Referenced Libraries: 


[] BA TestLibl 


















































6. Press the Finish button to create the project. 
The new project should be visible in the project navigator. 


Application Development 


F TestAppl 
» G2 Flows 
4 |i] References 
(> HB TestLibl 
(> HA TestLibl 
F Independent Resources 
Sac ile 





7. Click on the New... item under Project1. 
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__8. Select Message Flow from the menu. 


New Artifact 
Create a new artifact. 


af] Message Flow 


Subflow 


Message Model... 
frat Message Map 
ESOL File 

ce Decision Service 


Wii MOQ Service 


Fly Database Service 
Et Broker Schema 


ae Adapter Connection 
0 Database Definition 


ee Data Lineage Documents 


4. 


(i) New Message Flow 


Create a new message flow 


Select a container for the new message flow 




















Contsines 


Message flow name: 


Flow organization 
Use default broker schema 


Schema: | (default broker schema) 


__10. Press the Finish button to create the flow. 
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The message flow editor should open. A simple message flow will be constructed. 


__11. Expand the WebSphere MQ folder. 





$3 Palette 


BAe 


Low Favorites 













[3 
nl) Mocutput 
ae MOReply 
a) MQGet 
ray MQHeader 








[Jf MQOptinizedFlow (D... 
ams IMS 


__12. Select an MQInput node from the palette. 


__138. Drag the node onto the canvas. 


<2 Palette 
by & 
Low Favorites 

US WebSphere Mo ad 
2) MQInput 

(tl) MQQutput 

ae MoReply 

a MGQGet 

ay MOHeader 








| 4PPSLIBS2. I | 


__14. Change the name of the node to APPSLIBS2.IN. 


__15. Inthe Properties pane select the Basic tab. 


= oS (Problems | Fl Deployment Log 


(2 MQ Input Node Properties - APPSLIBS?2.IN 


Description 


Queue nane* 9 OPPSLIBS?.IN 


| Input Message Parsing 


Parser Options 





Advanced 


__16. Set the Queue name to APPSLIBS2.IN. 
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__ 18. 
19. 


_ 20. 


2k 


_ 22. 


__ 23. Save the message flow (Ctrl+S). Saha 
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Select an MQOutput node from the palette. 


‘| <2 Palette 

Ae = 
Lat Favorites 
US WebSphere Mo a2) 
J!) MOInput 












i) MQQutput . Ha 
a MORE — 
Suds SPPSLIBS2.I 
EE MQGet 

ie MQHeader 


Drag it to the right of the APPSLIBS2.IN node. 
Change the name of the new node to APPSLIBS2.OUT. 


Wire the Out terminal of the APPSLIB2.IN node to the In terminal of the APPSLIBS2.OUT node. 


x 








fa 


APPSLIBS2. IH 


APPSLIBS2, OUTI 





In the Properties pane select the Basic tab. 


ES £2 (2. Problems| FS Deployment Lag 


) MQ Output Node Properties - APPSLIBS2.0UT 


Description 


QUEUE manager name | 
Advanced Queue name APPSLIBSZ.OLIT 


Request 





Validation 


Enter APPSLIBS2.OUT as the Queue name. 





__24. Close the message flow editor. 


Flowd msoflow| 52 } 
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__ 25. Wewill now deploy this message flow. Select the Flow1.msgflow and drag and drop it on the 


_ 26. 
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default Integration Server. 


‘[ Applicatio £2 82, Pattemsex| ~ O 





| Application Development New... 


[> TestAppl 
> Ha TestLibl 
F Independent Resources 
» [= GeneratedBarFiles 
4 [= Project 
a (= Flows 
SE] Flowl .msqflow | 











Data Sourc | = ml 


tte Integratio i 





G2 Integratio 
fi) IBSN@ie 
fs, defa 
fs] TestAppl 


TestFlowl 

mi, TestLibl 
Autolnsurance 
El SubFlowl 


Notice how it is the Flow1 message flow alone that is deployed, and that the flow is notin an 


application or library container like TestApp1. 














te Integratio a: DataSourc | ~ O 
= G 


2 Integration Nodes 
fi IBSNODE 
fe, default 
&a) TestAppl 
Fel Flowl 
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Message flow and message set projects that were created using earlier versions of IBM WebSphere 
Message Broker can be used in the normal way with the version 9 toolkit. Project interchange files 
created with earlier versions of the broker toolkit can be imported using the version 9 toolkit. Any such 


projects will be visible under the independent resources view in the version 9 toolkit. 





Convert To Application or Library 


Application Development New... 
> TestAppl 
> HBA TestLibl 
a |e Independent Resources| 
» [> GeneratedBarFiles New 
» Project 
Copy 
Paste 
Delete 
Move... 
Rename... 
bs 
gq Export... 
Refresh 


Run in New Workbench... 


2. Press the right mouse button. 


3. Select Import from the menu. 
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1. Inthe project navigator pane, select the Independent Resources folder. 
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__4. — Expand the Other folder. 


Import a project and its dependent projects from a /ip file. 


Select an import source: 


type filter text 


(=> General 

(> Decision Services 
(2 BIB 

(= Java EE 

(= Modeling 

(= Plug-in Development 
(= Profiling 

(=> Run/Debug 

(=> Team 

(= Test 

[=> Web 

(> Web sernices 





kg VY VY VY VY VY ¥ YF ¥ YY ¥ YY ¥ YY 





__5. — Select Project Interchange as the type of import. 


__6. — Press the Next button. 
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7. Press the Browse button to locate the zip file. 
(iF) Import Project Interchange Contents 


Import Projects 
Import Projects from a zip file. 


From zip file: 


Project location root: $C:\student\AppsLibs\workspace 








| Select Referenced 
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__8. Navigate to the C:\student\AppsLibs\resources directory. 


__9. Select the MBv7_MsgFlowProject_PI.zip file. 


__ 10. 
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Organize ¥ New folder 


w Favorites 
MM Desktop | 3h ErrorHandlersJavaProject_Pl 
i Downloads 1) FileToQueue 
Pel Recent Places avi MsaFl 


Libraries 


[=| Documents 
al’ Music 

=| Pictures 
Be Videos 


( Computer 
ES. Local Disk (C:) 
G2 Shared Folders (\ + ¢ 


File name: =MBy?_MsqFlowProject_Pl 





Press the Open button. 


Date modified 

7/18/2011 5:36 AM = Compressed (zipp... 
1/19/2012 8:26 AM = Compressed (zipp... 
7/18/2011 5:36 AM = Compressed (zipp... 
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The zip file should now be visible in the From zip file box. The MBv7_MsgFlowProject project should 
be selected. 


__11. Press the Finish button to start the import. 


(ie) Import Project Interchange Contents 


Import Projects 
Import Projects from a zip file. 


From zip file: C:\student\AppsLibs\resources\MBv/_MsgFlowProjec 

















Project location root: C:\student\AppsLibs\workspace 


t= MBv?_MsgFlowProject 
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__12. Fully expand the imported project. It contains a message flow and an ESQL file. 
































Application Development 


> TestAppl 
Ha TestLibl 


> [= GeneratedBarFiles 
4 1 MBv?_MsgFlowProject 
F Flows 
Gel FileToQueue.msgflow 
a €4! ESQLs 
a (esl FileToQueue.esql 





a counter 
fehl File ToQueue _IncrementCounter 
iq outputQueue 

> L& Project 


The imported project will now be converted to an application. 


__13. Select the MBv7_MsgFlowProject message flow project in the Independent Resources view. 





Fle Edit Navigate Search Pssst Bee neds Hele ) 
New F 

ri +r my ox |v te G+ op ‘ Crash Reporter 
a — na Manage Library references — - — — —— 
ea Applicatio 2: 7 Patter’ 






































¢ Convert To Application or Library 
Application Development Migrate 
b> TestAppl Run in New Workbench... 
> BA TestLibl int) Convert to User-defined Node Project , = 
F Independent Resources An Application is a conte 
> = GeneratecairFiles Go Into create a solution. More... 
4 |; MBv?_MsgFlowProjec . ; 
ee Start by creating an int 
F Flows i 
FE] FileToQueue. Paste An Integration Service | 
: esq ESQLs nee and structure. More... 
4 (esl FileToQueue.es oF oe wii Start by creating a libra 
“ 
ee) SOREN ental A Library is a logical grou 


eal FileToQue 


fa] outputQuet ¥y Import... S35 Start from WSDL and/c 
> i> Projecti 22) Export... - Use this task to create a n 








__14. Press the right mouse button. 


__15. Select Convert to Application or Library>Convert Single Project from the menu. 
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__ 16. Select the an application radio button. 
[ (i) Convert to Application or Library 
Convert to Application or Library 


Convert the following projects to an application or library. 


Application or Library Project 
Convert Message Broker project ‘MBv/_MsgFlowProject’ to 


'@) an application 





__17/. Press the Finish button to start the conversion. 


The new application should now be visible as an Application, and it is removed from the Independent 
Resources folder. 


Application Development New... 
. |) MBv7_MsgFlowProject | — 


> TestAppl 
» BBA TestLibl 
a Independent Resources 
» [= GeneratedBarFiles 
> [= Projectl 
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1.6 Bar file editor 


The bar file editor is updated to recognize applications and libraries. Deploy operations can be 
implemented on an application basis, or can continue to be utilized for individual projects. 


__1. Point the mouse to a blank area of the project navigator. 


Application Development New. Start building your applicat 
» (A) MBv7_MsgFlowProject gig Message Flow 
' TestAppl Subflow 
> A TestLibl [= Message Model... 
a (&] Independent Resources 
» = GeneratedBarFiles ic Message Map 
> [= Projectl ik Af ESOL File 
New >| fi Broker Schema 
= ® Adapter Connection 
Lopy 
Database Definition 
Paste 


2 Data Lineage Documents 
Delete 
Move... ; 
Es: Integration Bus Test Client 


os, 


Rename... 
__2. Press the right mouse button. 


3. Select New>BAR file from the menu. 
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4. Enter AppsLibs as the Name. 





“(D) New BAR file 


Create a new BAR file 


Create a new BAR file resource 


Container: BARPfiles 
| Folder: < default> 


Name: AppsLibs 


5. Press the Finish button to create the broker archive file. 
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The broker archive editor will open. 


__6. — Confirm that the Applications and Services radio button is selected. 


Prepare 


Select deployable resources to include in the broker archive 


Deployable Resources 





AG Build and Save... J. Build Options 


Select an application to package all its contained resources. Resources within an application are isolated from other | 
applications. 


rr] Compile and in-line resources 
(@) Applications and Services§ (_) Message flows, libraries and other message flow dependencies 


Text filter: 


| 
\V| Remove contents of the archive before building | 


¥) Override configurable property values 
type filter text 


("| Add workspace project source files 
a | 





(¥| TA) MBv7_MsgFlowProject 
| TA) TestAppl 














(*)-Resource types marked with * will be automatically added to the broker archive if referenced by another selected artifact. 
4 


uli 
Prepare | Manage | User Log Service Log 


| 
__7. Select the MBv7_MsgFlowProject application. 


__8. — Press the Build and Save... button. 


__9. — Press the OK button to dismiss the pop-up dialog. 


"Adding to Broker Archive Fle 


~ Operation completed successfully. 
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Select the Manage tab to examine the contents of the broker archive file. 











Manage 
Rebuild, remove, edit, add resources to broker archive and configure their properties 
AS ge) SE] =) Filter by: | <Type filter text> 7 
Name Type Modified Size Path 
Application Jul #4, 2013 10:56:52 PM 3598 


MBv?_MsgFlowProject 


Kw 


* Command for packaging the BAR contents 


Prepare User Log | Service Log 


__11. Select the Prepare tab. 


Prepare 
Select deployable resources to include in the broker archive 


A Build and Save... Build Options 
‘Compile and in-line resources : 


Deployable Resources 
& There are also resources selected from the ‘Applications’ view. Switch Views to see these TESOUTCES, «ES RactertannnnrMinnennrnnnnncnrnnnnnnnnsnnnnnnsnnannennnnnunenssnnnenserennness 
\¥| Remove contents of the archive before building 
\V| Override configurable property values 


Applications and Services] @ Message flows, libraries and other message flow dependencies 
|| Add workspace project source files 


Text filter; type filter text Working set filter: | <all resources> 





™ c@ Libraries* 


| wa TestLibl 
1] & Independent resources 


(VE Flows 
[¥) EE! Flowl.msgflow - /Projectl/Flowl.msgflow 


(*)-Resource types marked with * will be automatically added to the broker archive if referenced by another selected artifact. 
TT r 




















4 


Prepare I anage UserLog Service Log 


Select the Message flows, libraries and other message flow dependencies radio button. 





12. 


__ 13. Select the Flow1.msgflow message flow that was built earlier. 


__14. Press the Build and Save... button. 


Lab 1 — Applications and Libraries Page 49 


IBM Software 


__15. If you get a pop-up dialog to Override configurable properties, click OK. 


SS 


| (i) Overnide configurable properties. 


You are about to override the configurable properties in the broker archive. This 
option can be changed tn the Prepare tab in the Broker Archive editor using the 
Override configurable property values option. 


Would you like to continue? 


("| Do not show this warning again. 


Cancel 


__ 16. 


Adding to Broker Archive File -—— «a = 





__17. Select the Manage tab. 





Manage 
Rebuild, remove, edit, add resources to broker archive and configure their properties 


ec | <=) S| » Filter by: | «Type filter text> 


Name Type Modified 
Flowl.msgflow Message flow Jul 24, 2013 11:06:00 PM 
MBv?_MesgFlowProject Application Jul 24, 2013 11:06:00 PM 


* Command for packaging the BAR contents 


| Prepare [Manage]User Log} Service Log 


The broker archive file now contains both an application and a message flow. 
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Size Path 


1726 
3598 
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__ 18. Close the AppsLibs.bar file. 


Ca Appslibs.bar >? JS 


1.4 Deploying resources 
The broker archive file that was created in the previous section will now be deployed to the default 
execution group. 


__1. Select the AppsLibs.bar broker archive file. 


Application Development New... 
MBwi_MsgFlowProject 
TestAppl 
mi, TestLibl 
BARs 

CE AppsLibs.bar -> BARfiles/AppsLibs.bar 
Independent Resources 





TestFlowl 
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__2. Drag it to the default Integration Server and drop it. 


At this point the default Integration Server contains two applications and an independent flow. 


_—— a: Data Source Explor = \/ 









4 &2 Integration Nodes 
4/2) IBINODE| 
» bak Configurable Services 
4 @, default 
4 3) MBv?_MsgFlowProject 
Fel FileToQueue 
[esl FileToQueue 
4 3s) TestAppl 
Fle] TestFlowl 
Fel Flowl 


The lab is now complete. The deployed flows and other resources will now be removed from the 
Integration Server. 


__3. Select the default Integration Server. 
fo In egration Node 3, Data Source Explor = 


, Ge Integration Nodes * Command for packaging the BAR co 


a i IBSNODE 









‘| 


Prepare Manage | User Log) Service Log 








yerty Value 


| = Delete 








*% Launch Debugger (Port is 14999) 








__4. — Press the right mouse button. 


5. Select Delete>All Flows and Resources from the menu. 
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6. Press the OK button to confirm the deletion. 


| (i) Confirm Deletion 


q Are you sure you wish to delete all flows and resources ? 


PK cancel 





The execution group should now be empty. 
#45 Integration Node £3 » [MB DataSource Explor) ~ O 
= i 





4 &2 Integration Nodes 
4 IBSNODE 
» Le Configurable Services 





fe default | 


1.8 Summary 


Applications and libraries are a major enhancement in IBM Integration Bus V9. They have far reaching 
implications and should make managing the Integration Bus environment substantially easier. 


This lab provides a basic introduction to applications and libraries. 


This ts the end of Lab 1. 
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Lab 2 DFDL and Message Model tooling 


2.1. Introduction to Message Model standards 


A message model is used by IBM Integration Bus to model a message format. The message models are 
all based on World Wide Web Consortium (W3C) XML Schema 1.0 (XSD). 


XML Schema is an international standard that defines a language for describing the structure of XML 
documents. It is suited to describing the messages that flow between business applications, and it is 
widely used in the business community for this purpose. IBM Integration Bus uses models that are 
based on XML Schema to describe the structure of all kinds of message formats, including message 
formats that are not XML. 


Data Format Description Language 1.0 (DFDL) is an open standard modeling language from the Open 
Grid Forum (OGF) that builds upon the features of XML Schema 1.0 in order to model and validate all 
kinds of general text and binary data. It uses standard XSD model objects to describe the logical 
structure of data, together with DFDL annotations that describe the physical text or binary representation 
of data. IBM Integration Bus uses DFDL schema files to describe text and binary data, including industry 
standard formats. 


DFDL Is not intended to be used to model XML documents (use normal XML Schema files). 


Support for DFDL in IBM Integration Bus includes: 


e DFDL parser and domain 

e DFDL schema file creation wizards 

e DFDL schema editor for modeling text and binary data formats 

e DFDL Test perspective for testing your DFDL schema files 

For more information about DFDL, you can go to the Open Grid Forum (OGF) web site. IBM Integration 
Bus supports DFDL 1.0, as defined in the following document: Data Format Description Language 
(DFDL) 1.0. 


Unlike previous versions of IBM Integration Bus, you do not need to create a Message Set project and a 
Message Set to model a message type (although MRM Message Models are still Supported); you just 
have to create a DFDL schema file. 


Message Create Refine Test 

Modeling CSV CSV Message 

Introduction Message Message Model 
Model Model 
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2.2 Creating a CSV Message Model 


This lab will create a Message Model that will model a CSV file. The file has a header record, and 
several detail records, but no trailer record. 


Records are delimited by CRLF characters, and fields within each record are delimited by a comma. 
The Library project type will be used to store the Message Model. 

This lab will start from a blank workspace. 

__1. Select File>Switch Workspace Other. 

__2. Select the C:\student\DFDL\workspace workspace. 


__3. Press the OK button to continue. 





(>) Workspace Launcher 


oelect a workspace 


IBM Integration Toolkit stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 





__4. — Click on New Library. 


[4 ApplicationDe £3 oc, Patterns Explor) “~ OF 

Sey” 
Application Development New... 
New Application... 


New Integration Service... 
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__5. Set the Library name to MessageModellingLibrary. 


6. Press the Finish button. 


wo New Library 





Create a new library 


4 library allows re-usable artifacts to be grouped and managed together. Enter a name for the new library. 


Cancel 


__7. Select the MessageModellingLibrary library. 
__8. — Press the right mouse button. 
__9. Select Import from the menu 


Application Development Export XSDs from Library 


Migrate 





Go Into 
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__10. Expand the General folder. 
__11. Select File System. 


__12. Press the Next button. 





Select 


Import resources from the local file system inte an existing project. 


Select an import source: 
type filter text 

[) Archive File 
LY Existing Projects into Workspace 
L. Existing RAD 6.x Data Definition Project 
G 

i ES) Preferences 

| | > cvs 











(?) | < Back LL Net> | ae 
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__13. Press the Browse button for From directory. 


Oc oes 


File system 


Source must not be empty. 


From directory: Be = | 


Filter Types... | Select All All | Deselect All All 


Into folder; MessageModellingLibrary 


Options 
Overwrite existing resources without warning 


Create complete folder structure 


Advanced >> 
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__14. Navigate to the C:\student\DFDL\data directory. 
__15. Select the data directory. 

__16. Press the OK button. 

"Import from directory Cox 


Select a directory to import from. 


4 )) DFDL 
] 
a rFESOUrTCES 
> a workspace 
> |) dotNET 


> r FileProcessing 


> |) Files 
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__17. Select the employees.csv file. 


__18. Press the Finish button to perform the import. 


File system 


Import resources from the local file system. 
From directory: § C:\student\DFDL\data 


rr mE Companies.tt 
ee a dae 


EE rm = sarees BadPhoneNumber.dat 
ial m = purchases.dat 


Filter Types... Select All 


Into folder: MessageModellingLibrary 


Options 
Overwrite existing resources without warning 
Create complete folder structure 


Advanced >> 
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__19. Expand the Other Resources folder. 


__20. Double-click the employees.csv file. 


Application Development New... 


i, 
( Other Resources 


__21. Select the Select a program from a list of installed programs radio button. 
__22. Press the OK button. 
Windows - = =x 
Windows can't open this file: 


File: employees.csv 


To open this file, Windows needs to know what program you want to use to 
open it, Windows can go online to look it up automatically, or you can manually 
select from a list of programs that are installed on your computer. 


What do you want to do? 


() Use the Web service to find the correct program 
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__ 23. Select the Notepad utility. 


__ 24. Press the OK button. 


Choose the program you want to use to open this file: 


Recommended Programs 


| Notepad A d WordPad 
& § Microsoft Corporation 


Microsoft Corporation 


Other Programs 


M Type a description that you want to use for this kind of file: 


(| Always use the selected program to open this kind of file —E— 


If the program you wantis notin the list or on your computer, you can look for the appropriate program on the 
Web, 
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The file data will be opened in a notepad session. There is a header record and 42 detail records. Each 
detail record has 12 fields. 


__25. Examine the file data. 


__ 26. Close the notepad window. 


© employees.csy - Notepad 


File Edit Format ‘Yiew Help 


~ompany1,42,123 Street, winchester, UK 

"QO00LO0", "CHRISTINE", "I", "HAAS", "ADO", "3978", "1995-01-01", "PRES ".18,"F", "1963-08-24",152750.00 
"900020", "MICHAEL", "L", "THOMPSON", "BOL", "3476", "2003-10-10", "MANAGER ",18, "mM", "1978-02-02", 94250.00 
"00030", "SALLY", "A", "KWAN", "COL", "4738", "2005-04-05", "MANAGER ",20,"F", "1971-05-11", 98250.00 
"900050", "JOHN", "B", "GEYER", "EOL", "6789", "1979-08-17", "MANAGER ",16, "mM", "1955-09-15", 80175.00 
"900060", "IRVING", "F", "STERN", "DLL", "6423", "2003-09-14", "MANAGER ",16, "mM", "1975-07-07", 72250. 00 
"oo0070", "EVA", "D", "PULASKI", "D21L", "7831", "2005-09-30", "MANAGER ",16, "F", "2003-05-26", 96170.00 
"900090", "EILEEN", "W", "HENDERSON", "E11", "5498", "2000-08-15", "MANAGER ",16,"F", "1971-05-15", 89750.00 
"00100", "THEODORE", "OQ", "SPENSER", "E21", "0972", "2000-06-19", "MANAGER ",14, "mM", "1980-12-18", 86150. 00 
"QOOLLO", "VINCENZO", "G", "LUCCHESSI", "A00", "3490", "1988-05-16", "SALESREP",19, "mM", "1959-11-05", 66500. 00 
"900120", "SEAN", " ", "O'CONNELL", "AGO", "2167", "1993-12-05", "CLERK "\14, "mM", "1972-10-18",49250. 00 
"00130", "DELORES", "M", "QUINTANA", "COL", "4578", "2001-07-28", "ANALYST ",16,"F", "1955-09-15", 73800. 00 
"900140", "HEATHER", "A", "NICHOLLS", "COL", "1793", "2006-12-15", "ANALYST ",18,"F", "1976-01-19", 68420.00 
"9OO0L5SO", "BRUCE", " ", "ADAMSON", "DIL", "4510", "2002-02-12", "DESIGNER",16, "mM", "1977-05-17",55280.00 
"00160", "ELIZABETH", "R", "PIANKA", "DIL", "3782", "2006-10-11", "DESIGNER",17, "F", "1980-04-12",62250.00 
"QOOL7O", "MASATOSHI", "J", "YOSHIMURA", "DIL", "2890", "1999-09-15", "DESIGNER", 16, "M", "1981-01-05",44680. 
"OOO1L80", "MARILYN", "S", "SCOUTTEN", "DIL", "1682", "2003-07-07", "DESIGNER",17, "F", "1979-02-21", 51340. 00 
"900190", "JAMES", "H", "WALKER", "DLL", "2986", "2004-07-26", "DESIGNER",16, "M", "1982-06-25", 50450. 00 
"900200", "DAVID", " ", "BROWN", "DLL", "4501", "2002-03-03", "DESIGNER",16, "M", "1971-05-29", 57740.00 
"900210", "WILLIAM", "T", "JONES", "DLL", "0942", "1998-04-11", "DESIGNER",17, "mM", "2003-02-23", 68270. 00 
"900220", "JENNIFER", "K", "LUTZ", "DIL", "0672", "1998-08-29", "DESIGNER",18, "F", "1978-03-19",49840.00 
"900230", "JAMES", "I", "JEFFERSON", "D221", "2094", "1996-11-21", "CLERK ".14, "mM", "1980-05-30",42180. 00 
"900240", "SALVATORE", "M", "MARINO", "D21", "3780", "2004-12-05", "CLERK "17, "mM", "2002-03-31",48760.00 
"900250", "DANIEL", "S", "SMITH", "D21", "0961", "1999-10-30", "CLERK "S15, "mM", "1969-11-12",49180. 00 
"900260", "SYBIL", "P", "JOHNSON", "D21", "8953", "2005-09-11", "CLERK ",16,"F", "1976-10-05",47250. 00 
"900270", "MARIA", "L", "PEREZ", "D21", "9001", "2006-09-30", "CLERK ",15,"F", "2003-05-26", 37380. 00 
"900280", "ETHEL", "R", "SCHNEIDER", "E11", "8997", "1997-03-24", "OPERATOR", 17, "F", "1976-03-28", 36250. 00 
"900290", "JOHN", "R", "PARKER", "E11", "4502", "2006-05-30", "OPERATOR", 12, "mM", "1985-07-09", 35340.00 
"900300", "PHILIP", "X", "SMITH", "E11", "2095", "2002-06-19", "OPERATOR",14, "mM", "1976-10-27",37750.00 
"900310", "MAUDE", "F", "SETRIGHT", "E11", "3332", "1994-09-12", "OPERATOR",12,"F", "1961-04-21", 35900. 00 
"900320", "RAMLAL", "V", "MEHTA", "E21", "9990", "1995-07-07", "FIELDREP",16, "mM", "1962-08-11", 39950. 00 
"900330", "WING", " ", "LEE", "E21", "2103", "2006-02-23", "FIELDREP",14, "mM", "1971-07-18",45370.00 
"900340", "JASON", "R", "GOUNOT", "E21", "5698", "1977-05-05", "FIELDREP",16, "mM", "1956-05-17",43840. 00 
"200010", "DIAN", "I", "HEMMINGER", "AOO", "3978", "1995-01-01", "SALESREP",18, "F", "1973-08-14",46500. 00 
"200120", "GREG"," ", "ORLANDO", "Ado", "2167", "2002-05-05", "CLERK "\14, "mM", "1972-10-18", 39250. 00 
"200140", "KIM", "N", "NATZ", "COL", "1793", "2006-12-15", "ANALYST ",18,"F", "1976-01-19", 68420.00 








__2/. Inthe Integration Toolkit click on New. 


Application Development [ew.] 
| 
| 


| El mk MessageModellingLibrary | 
elie Other Resources 
base (=) employees coy 


__ 28. Select Message Model from the menu. 





New Artifact 


Message Flow 
El Subflow 


= Message Model... 





ret Message Map 
lA& ESOL File 
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__ 29. Select the CSV text radio button. 


__30. Press the Next button. 








Create a new message model file = 
Select the message model type or format = 
AML 
() SOAP XML XML data for use in Web Services. 
) Other XML All other AML data. 
~lateie 1 ha ry 
(@) CSV text Comma Separated Values data, a delimited text format commonly used as an export 


format by spreadsheets and databases. 
(-) Record-oriented text Text data formats where delimited fields are grouped into records. 
©) COBOL Data for COBOL programs 
©c Data for C programs 
() Other text or binary = All other text or binary data formats. 


Enterpnse Information Systems 


() SAP Data from SAP systems including [Doc and BAPI 
) Siebel Data from Siebel systems 
) PeopleSoft Data from PeopleSoft 
() JD Edwards Data from JD Edwards systems 
Other 
() CORBA IDL Data from CORBA 
‘| © Database record Records from relational databases 
(”) MIME Data for extended email format 
() IBM supplied Predefined data format 


— 
(?) < Back Next > Finish 
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__31. Select the Create a DFDL schema file using the wizard to guide you radio button. 


__ 32. Press the Next button. 


I) New Message Model BP {oj x, 


CS¥ text 
Choose how you would like to create your CSV message model, = 


WebSphere Message Broker requires a message model in order to parse, serialize and validate CS¥ data. 4 message model 
also speeds up development of your message broker applications by enabling ESQL content assist and graphical maps. 


Comma Separated Values data is modeled by Data Format Description Language (DFDL) schema files. DFDL is a standard 
From the Open Grid Forum for describing all kinds of text and binary data, 


( Create a DFDL schema File using this wizard to quide you. 
Create an empty DFDL schema file, I will model my data using the DFDL schema editor 


( Import or replace the IBM supplied DFDL schema property defaults for CS¥. 


|Hans On |DFDL 
AOD corp 4163cc, V8 





(?) < Back Finish | Cancel | 
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__ 33. Make sure that the Project is set to MessageModellingLibrary. 
__ 34. Enter Employee as the DFDL schema file name. 


__ 35. Press the Next button. 


Create a Data Format Description Lanquage (DFDL) Schema 


Specify the location and name of the DFDL schema, and specify the name of the message. 


Application or Librans = MessageModellingLibrary 
Folder: 


DFDL schema file name: J Employee 


Message name: Employee 


@) 
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__ 36. Select the first record is a header check box. 
__37. Enter 12 as the Number of fields. 


__38. Press the Finish button. 


Contigure schema tor Co¥ data 


Provide settings for a new schema that will model CSV data. 


Record settings 
End of record character: | Carnage Return & Line Feed - 2oCR;%aLF; 
Blank records will be skipped) 
The first record is a header, 
Field settings 
Number of fields: 
| Create default values for fields 


Encoding code page options: 














(@) Dynamic (provided to the processor by the application at runtime) 
() Fixed UTF-8 


Global settings 
Escape scheme: | CSV Escape Scheme 
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There should be a new folder in the library with an XSD file called Employee.xsd (under the default 
namespace). This is the Message Model that was just created. This is a standard DFDL XSD, with no 


specific annotations for IBM Integration Bus. 


There is another XSD file under Schema Definitions called "CommaSeparatedformat.xsd". This "Helper 
schema file" was automatically added by the CSV wizard and contains CSV-specific defaults for all the 
DFDL properties. This is required because DFDL does not have built-in defaults, so if an object needs a 
property, a value must be supplied. To ease this task, the wizard creates a helper DFDL schema for 


each kind of data (such as COBOL and CSV.). 


These files are related by an import statement in the schema references section of the Employee.xsd 





i, A= i 


file. 
eo hb Vv aml 
ws i) =} ER EG == +1 = 
Application Development New... |) lest Parse Model Test Serialize Model Hide properties Show advanced Show allsections Focus on selected Show quick outline 








>> 





essages 





=] mA MessageModellingLibrary 
|S. Schema Definitions 
: E et (default namespace) ge 
fi (a) Employee.xsd 
=] en http: /fwww. ibm, com/dfdl{CommaSeparatedF 
; (a) CommaSeparatedFormat.xsd 
=) Other Resources =) ces 
=) employees.csv # [e] header 
+) [e] record 
Add a Local Element 








Name Type Min Occurs 











=| [e| Employee 


sequence 
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/@al\jat ?+ x|/ BB 


nessage is 4 global element that models an entire document of data. 


Max Occurs 


1 
1 


unbounded 





=) Representation Prope 1 





Employee (Element) 


Default Value Sam [r text> He |S | HH) IE 
Property | Walue | (2) 


Conmment 








General 











Encoding Ss <dynamically s ... | 


Byte Orde =, bigEndian 
Content 

Length kir=, delimited 
Occurrence: 

Min Occur =, 1 

Max Occu aA 1 


Delimiters 


Ea 
a 
































Initiatay enn initiatnr > 
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Take a look at the Representation Properties view on the right hand side. Notice the "inheritance" icon to 
the right of the "Length Kind" property. (Hint: You might have to adjust the column lengths in the 
Representation Properties view to see the full contents.) 


In this case, the "Length Kind" property was inherited from the "CommaSeparatedFormat" helper 
schema file that the wizard automatically imported. 


__39. Hover over the inheritance icon to discover its origin. 








Ep Ey = e & fe 5 i 
Test Parse Model Test Serialize Model Hide properties Show advanced Show allsections Focus onselected Show quick outline 1 
Vlessages Blgt + x EL E=| Representation Properties 
message is a global element that models an entire document of data. Employee (Element) 2) 
Name Type | Min Qecurs | Max Occurs Default Value | | Sarmple Valu ss leesrll ed us % | = 
=| [¢| Employee || Property Value PF 
[=] ooo Sequence 1 1 Comment =| 
+! [e| header 1 1 4 General 
it) |) record i unbounded Encoding (cod, <dynamically s [i 
Add a Local Element as 














smears inherited from = named format 
Jon | ymimat | 





Press “F2° for focus 
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- 
P) prokee Cewelo BL. Patterns Capi 





Take a look at the different parts of the DFDL Editor: 


1) Applications and Libraries / Projects view: In the top of this view you will find the 
Applications/Libraries and in the bottom the projects. All the DFDL XSD files will be located under the 
"Schema Files" folder inside of a project. 

2) Logical structure view: This is the core of the DFDL Editor. Here you will work with the Message 
Models. 

3) DFDL properties: Shows the DFDL properties of the selected elements in the editor view. These 
were moved from the traditional properties window to provide better viewing. 

4) Outline view: Shows the complete outline of the current DFDL Message Model. 

5) Problems view: In this view you will be able to see all the warning and errors of your project. 

6) Icon Bar: Several actions can be started from the icons in this bar: 


Ep EY = fe & 





Test Parse Model Test Serialize Model Hide properties Show advanced Show all sections Focus on selected Show quick outline 


e Test Parse Model: Launches the DFDL Test Perspective to test-parse sample data against your 
selected message model. 

e Test Serialize Model: Launches the DFDL Test Perspective, to test-serialize sample data by 

using the selected DFDL schema. 

Hide properties: Hides the Representation Properties view. 

Show advanced: Shows the advanced Representation Properties. 

Show all sections: Shows all the available sections of the DFDL Message Model in the Editor. 

Focus on selected: Shows only the selected element in the Editor. 

Show quick outline: Shows a hanging outline view of the message model in the Editor. 
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The DFDL Editor in the center of the screen describes data elements. Expand the header element. 


Take a look at the columns: 


Name: name of the data element 

Type: data type (such as string, int, Boolean, decimal or date) 

Min Occurs: minimum amount of occurrences expected (0 or greater) 

Max Occurs: maximum amount of occurrences expected (from 1 to unbounded) 

Default Value: used to provide the logical value of a required element while parsing or 
serializing messages when the element is missing 

e Sample Test Data: can be used to generate a logical instance of the model as you will see 
later on 


Name Type Min Occurs | Max Occurs Default Value | | Sarnple Value 
=| [€] Employee 
[=] seo Sequence 
=| |e} header 
=) eo Sequence 
head field string 
head field? string 
head field3 string 
head field4 string 
head field5 string 
head field6 string 
head field? string 
head fields string 
head field9 string 
head fieldl0 string 
head fieldll string 
head fieldl? string 
+) [e| record unbounded 
Add a Local Elernent 


head val 
head val 
head val 


head value 





head valu 
head val 
head val 
head valu 
head_val 
head valu 


head val 








ee 

















head val 
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Fields 6 to 12 will now be deleted from the header element. 


__40. Expand the header element. 


__41. Select head_field6. 


IBM Software 


__42. Hold down the Ctrl key and select fields head_field7 through head_field12. 


Name 
=| [e] Employee 
[=] os Sequence 
=] [e] header 
[=] os Sequence 
head fieldl 
head field? 
head fields 
(e| head field4 
head_field5 
head field6 
(¢| head_field? 
head_field& 
head _field? 
head _field10 
(¢| head_field11 
head fieldl? 
(+) [é] record 
Add a Local Elernent 





Type 


__ 48. Press the right mouse button. 


__44. Select Delete. 


Min Qecurs 


N.B. You can also just press the Delete key. 


head _field10 
head_field11 
head fieldl2 





string 


string 


string 


Ctrl+x% 
Ctrl+C 
Delete 


Max Occurs 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 


unbounded 


Sample Value 


head valuel 
head values 
head values 
head valued 
head _value5 
head_value6 
head_value? 
head _valueé 
head valued 
head _valuelO 
head_valuell 
head valuel? 


head valued 


1 
1 head value? 


head value’ 


head valued 
head valuelQ 
head valuell 


head valuel? 














[+] [@] record 
Add a Local Elernent 
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Change the names of the remaining five header fields as shown. 
45. Click on the name of the first element. 
__46. Change the name as shown. 


__47. Use the down arrow key to move to the next element name. Press the Enter key when the last 
name is changed. 





































































Name Type Min Occurs’ | Max Occurs Default Value | | Sample Value 
=| [e| Employee 
[=] oes Sequence 1 1 
=) [@| header 1 1 
S| ooo See 1 1 
1 1 head _valuel 
1 1 head value? 
1 1 head values 
1 1 head valued 
1 1 . head_valueS 
1 unbounded 


Add a Local Element 
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__48. Collapse the header element. 


__49. Expand the record element to show the 12 fields created by the wizard. 


NWarme 


=| [€] Employee 
[=] om Sequence 
+] |e] header 
=] [e] record 


(=| ooo 


Add a Local Elerment 


SEQUENCE 


field 
[e] field2 
[e| field3 
(e| field4 
(e| fieldS 
(e| field 
[e] field? 
field& 
field? 
(é| field 10 
Tieldi1 
[e| field12 


Type 


string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
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Min OQecurs 


ee AO Ae OO DO Oe AO ee PO Oe Oe BO ee ee ee 


Max Qecurs Default Value 


unbounded 


el ee el el 
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Sample Value 


valuel 
valuez 
values 
valued 
value5 
valued 
value! 
valued 
valued 
valuelQ 
valuell 
valuel? 
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__ 50. 


Change the field names to the following: 


{ 
2 


3 
4 
5 
6 


) EmpNo 7) HireDate 
) FirstName 8) Job 

) MidInit 9) EdLevel 
) LastName 10) Sex 

) WorkDept 11) BirthDate 
) PhoneNo 12) Salary 


Again use the down arrow to move from one field to the next. Press the Enter key to complete the 
rename operation. 


Name 


[=] Le| Employee 


[—] ood sEq WVENCeE 
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+) [¢| header 
= [e] record 
S) oes ceQuen 

Empho 
FirstName 
MidInit 
LastName 
WorkDept 
PhoneNo 





HireDate 
Job 

[¢| EdLevel 
Sex 

[¢| BirthDate 
[e| Salary 
Add a Local Element 


Type 


string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 
string 


Min Qecurs 


Max Occurs Default Value | | Sarnple Value 


unbounded 


valuel 
valuez 
values 
valued 
value5 
valued 
value! 
valued 
valued 
valuelQ 
valuell 
valuel? 


ll el 
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__51. Click in the Type column for the HireDate field. 


__52. Select date as the Type. 


Name Type Min Occurs | Max Occurs Default Value | | Sarnple Value a 
=| [e] Employee 
[=] oss Sequence 1 1 
+] |e] header 1 1 
=] [e] record 1 unbounded 
[=] os Sequence 1 1 
[e| EmpNo string 1 1 valuel 
(| FirstWame string 1 1 valuez 
(e| MidInit string 1 1 values 
LastName tring 1 1 valued 
[e¢] WorkDept ng 1 1 valued 
PhoneNo wing 1 1 value6 
(| HireDate : J. 1 value? 








Le] Job value’ 

[e| EdLevel < Anonymous? valued 

Le] Sex [=] boolean = valuelO 

(e| BirthDate [=] byte valuell 
Salary =f date i valuel2 
Add a Local Element [=] dateTime 


[=] decimal 
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__58. Click in the Type column for the BirthDate field. 


__54. Select date as the Type. 


Name Type Min Occurs | Max Occurs Default Value | Sample Value 
=| [é] Employee 
[=] os Sequence 1 1 
(e| header 1 1 
[=] [€] record 1 unbounded 
[=] om Sequence 1 
[e] EmpNo - valuel 
Browse... 
(e| FirstName Siena value? 
MidInit E] boolean valued 
LastName E] byte | valued 
[¢] WorkDept = . valued 
PhoneNo il (=) dateTime valued 
(¢| HireDate [=] decimal 2010-12-31 
Job [=] double valued 
(e| EdLevel valued 
[e| Sex valuelO 
BirthDate valuell 
valuel? 





Salary 
Add a Local Element | 
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__55. Click in the Type column for the EdLevel field. 


__56. Select int as the Type. 


Name Type Min Occurs | Max Occurs Default Value 


=| [e] Employee 
[=] oes Sequence 
+] [| header 
[=] [e] record 
[=] om Sequence 

[e¢| EmpNo 
(e| FirstName 
MidInit 
(e| LastName 
[e¢] WorkDept 
(¢] PhoneNo 
HireDate 





[e] Job 
(é] EdLevel 3 
3eK [=] boolean 
BirthDate =] byte 

Le] Salary }| —!) date 

Add a Local Element [=] dateTime 
[=] decimal 
| [=] double 


= : [=] float 
'roperties ef if Problems| FA Deploy 


terbi 


Lab 2 - DFDL and Message Model Tooling 


1 
1 
unbounded 
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Sample Value 


valuel 
value2 
values 
valued 
values 
valued 
2010-12-31 
valued 
valued 
valuelQ 
2010-12-31 
valuel? 
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__57. Click in the Type column for the Salary field. 


__ 58. Select decimal as the Type. 





Name Type Min Occurs | Max Occurs Default Value | | Sample Value 
=| |e] Employee 
[=] oes Sequence 1 1 
+] |e] header 1 1 
I [e] record 1 unbounded 
[=] os Sequence 1 1 
[e| EmpNo 1 valuel 
FirstName es value? 
(e| MidInit ie mms values 
(e| LastName J boolean valued 
[e] WorkDept El byte | valued 
[€| PhoneNo E] date 77 valued 
[e] HireDate VW datetime 2010-12-31 
[e| Job | valued 
le] EdLevel [=] double 1 
[e| Sex valuelO 
[é] BirthDate 2010-12-31 
Salar valuel2 
Add a Local Element 
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__59. Select the header field under the Employee >sequence elements. 


[| *Employeeasd £3 | 
ER Eq =| es & fe) i= EF 
Test Parse Model Test Serialize Model Hide properties Show advanced Show allsections Focus onselected Show quick outline Create logical instance 


ell € ft +x|/ AB | [) Representation Prope Asserts and Discrimi| ”"1 


+ Messages 


A message 5 a global element that models an entire document of data. header (Element) 


=r text> 


Name Type Min Qecurs | Max Occurs 


=] [€| Employee Property 


[E) oes Sequence Comment 


! General 


PT unbounded Content 
=] om Sequence 1 Occurrences 
[e] EmpNo string Delimiters 4 


G vets an : Terminator 26CR:96LF;9WSP*: 
Le) MidInit string 
[é| LastName string 


TT + Sample Test Data 





The terminator is the delimiter between records or between the header and the records. Since a CRLF 
sequence does not consist of printable characters the terminator is entered using special character 
sequences as shown. 


There is a third Separator "%WSP*" which was added by the wizard because it automatically skips blank 
records (white space). "%WSP" (whitespace) is a DFDL character entity which groups several 
whitespace characters. 


"%WSP*" (optional whitespaces) is a DFDL character class which implies the parser will ignore 
whitespace characters. 
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__60. Select the record element (if necessary). 


__61. Examine the Terminator property. 


— Representation Prope Asserts and Discrimi 
Name Min Qecurs | Max Occurs Defar 


record (Element) @ 


=| [e] Employee 
[=] oss sequence 
4) [€| header — 








or text> 4 oe | 5, | 


unbounded Property (3) | 


Comment 


General 























[=] oe Sequence 
[e] EmpNo string 
[e) FirstName string 
[e| MidInit string 
[€| LastName string 
[e|] WorkDept string 
PhoneNo string 
[e| HireDate date 
[e| Job string 
je) EdLevel int 
Mi 


Content 


Ocourrences 


Max Occurs unbounded 
Occurs Count Kind implicit 
Delimiters "4 


Terminator FoR: SoLF: So WSP*: 




















ee ee A ce A Oc 


Sample Test Data 





__ 62. Save the Message Model (Ctrl+S). sg: 


Page 82 Discovering what is new in IBM Integration Bus v9.0 


IBM Software 


2.3 Test the Message Model 


The Message Model will be tested to validate that it parses the sample data correctly. 


__1. Click on the Test Parse Model button. 


ER EY = # 


Test Parse Model § Test Serialize Model Hide properties Show advanced 


Messages El| gl t > | ER le 


4 message is 4 global element that models an entire document of data, 





Name Type Min Occurs 
=| [e| Employee 
=) oes SEQUENCE 1 
+) [e) header 1 
=) [e] record i 
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__2. Select the Content from a data file radio button. 


__3. Press the Browse button. 


r ——— 
(D) Test Parse Model ——_—_ >. =») la 
—_— — 


Message 
Select message for testing. More... 


Message name:* | Employee ¥ 


Parser Input 
Select content to be parsed against schema. 
() Content from 'DFDL Test - Serialize’ view 























Input file narme:* : 


Specify runtime configuration. 
Runtime enceding options 
Provide runtime values for properties which have been configured in the model to be dynamically set. 
More... 


Encoding (code page): UTF-8 


Floating point format: | IEEE f. 


Byte order: (—) Little endian ‘@) Big endian 


Runtime validation 
| Validate data against schema More... 


























eh 
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__4. Select the employees.csv file under the MessageModellingLibrary library. 


_ 5; Press the OK button. 





®) File Selection _ SS — 


_ ill 
Select an input file: 
si MessageModellingLibrary 
> [=> IBMdefinec 


(| Select an input file from the file system 


Browse... 
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6. Press the OK button. 


ume, 


Message 


Select message for testing. More... 
Message name:* | Employee A 


Parser Input 

Select content to be parsed against schema. 
() Content from 'DFDL Test - Serialize' view 
(@) Content from a data file 


























Input file name:* /MessageModellingLibrary/employees.csv 


Specify runtime configuration. 
Runtime encoding options 
Provide runtime values for properties which have been configured in the model to be dynamically set. 
More... 


Encoding (code page): 
Floating point format: |IEE 
Byte order: () Little endian (@) Big endian 


Runtime validation 
Validate data against schema /More... 
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__7. Press the Yes button to continue. 


(>) Confirm Perspective Switch 


The DFDOL Test perspective sets up the views needed to help to test DFDL schemas. 
Testing can be done tn other perspectives, but the views might not be optimally 
setup by default. 


Do you want to open the DFDL Test perspective now? 


("| Remember my decision 





A pop-up dialog should display the results of the parsing test. 


__8. — Click the X to close the dialog box. 


G@) Parsing completed successfully. | =] 


Tips: 
«Selecting an element in the DFDL editor will cause the parsed input to focus only on data pertaining to the selected elernent, 


«To view the logical instance that was created by the DFDL parser, click the Open DFDL Logical Instance View toolbar butkon, or click bere, 
«To view the trace captured while running the CFDL parser, click the Open DFOL Trace view toolbar button, or click here, 


T Do not display this message again 
SS ___________ll!|!ylléJ€_T]|__LL _...i€iil!!!!ffl!fST_l_flflff_________________4_4_4_H4_HH_H4__4_4_HHHHHH_4_H4_4H_HHHHH__H_4-" 
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The DFDL Test perspective has several views: 


e Parse: Allows you to parse a file using the message model in the editor. 
e Trace: Has a detailed trace log of the testing activities. Very helpful to find the cause of errors. 
e Logical Instance: Gives you a view of the parsed message tree. 
e Serialize: Allows you to generate a file from the message model. 
[0] Employeeasd £3 ~ ah (Bj DFDL Test - Logical Instance 5 Bl|ara 





2 BE Data source: <From 'DFDL Test - Parse’ view> 








S 
Name Type Min Occurs | Max Occurs Default Value || Sample Value 
Tree View \_ XML View 
=] |e} Employee 
ie) a Name Type 
=] ses sequence ae 

mployee 

+ [e| header Pry’ 
header 
=| [e| record unbounded =e 
=) ses sequence record 
[€] EmpNo | record 
(e| FirstName record 
record 


EG DFDL Test - Serialize fe DFDL Test - Trace 


5. Navigator | [2 Problems| E}, DFDL Test - Parse 52 
DFDL Test - Parse: Runs the DFDL parser with the provided physical input data and selected message, and updates the logical instance view with the result of the parse. 
Status: Parsing completed: Tue Jul 23 03:31:08 EDT 2013 














Message: Employee (/student/DFDL/workspace/MessageModellingLibrary/Emp 


Value 


Wh} > 


O1aa ela siEeOr"4 


Wl 


Input 
Data: | /MessageModellingLibrary/employees.csv 4 | Browse... | Encoding (code page): | UTF-8 ’ Message: Employee (/MessageModellingLibrary/Employee.xsd) 
Parsed Input 

Characters 

1 Company1,42,123 Street Winchester UK 

2 "000010", "CHRISTINE" "I")"HAAS ")"A00""3978"0"1995-01-01")"PRES "Ois)"F")"1963-08-24"9152750.00 

3 "000020", "MICHAEL" "L" "THOMPSON" "BO1"2"3476"()"2003-10-10")"MANAGER ")18/0"M"10"1978-02-02"1)94250.00 

Selection in DFDL Editor Character Selection InInput — Byte Selection In Input 

Selected: Employee : <Anonymous> (complex) | Repeating index: 1 Range in parsed input: 0 - 4169 Row:0 | Column: 0 Offset: 0 Length: 0 


The input text has been highlighted to differentiate the separators (",") that the parser has detected. 


Parsed Input 
Charackers 


1 Companyil42)1235 Street Winchester_UE 


2 "00010" "CHRISTINE"] "I" "Haas "2 "Ago" 3978'"1995-01-01"9"PRES "MicB' FB 1963-08-24"§152750.00 
3 "000020", "MICHAEL" "L" "THOMPSON" "BO1l" "3476". "20035-10-10" "MANAGER "1a l"M"l"1976-02-02"\))94250.00 
4 "COOOSO"M'"SALLY "aA" oes ee "ay 3g" eee de. ee fae Oe Peeters See 

5 "OOOOSO", "JOHN" "BB" "GE¥YER" "EOL", "6789"_"1979-068-17"_ "MANAGER "l16."M"2"1955-09-15"_80175.00 

6 "OOOO60" "IRVING" L"F" "STERN" "D111" "6423" "2003-09-14" "MANAGER "l1i6l"M" "1975-07-07" l72250.00 
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The Logical Instance view is located in the top right corner. This shows the parsed message tree for the 


employees.csv file 


[Ei DFDL Test - Logical Instance 23 


Data source: =<From ‘DFDL Test - Parse’ view 


Message root: Employee (!MessageModelingLibrary_broker/Employee, xsd) 


Tree View SMIL View 


Name 


=] Employee 
) header 
4 record 
+) record 
+ record 


+ record 
+ record 
record 
record 
+ record 
+) record 


Expand a few records to check that the parsing was correct. 


[Ej DFDL Test - Logical Instance 


Data source: <From ‘'DFDL Test - Parse’ view> 


Message root: Employee (iMessageModelingLibrary_broker/Employee, xsd) 


Tree View APL view 


Name 
[=| record 
Empho 
Firsthame 
MidInit 
LasthWame 


WorkDept 
Phonela 
HireDate 
Job 
Edlevel 
Sex 


Pa 


Type 


xsistring 
“sistring 
xsistring 
“sistring 
xsistring 
xsistring 
“sidate 
xsistring 
“sink 
xsistring 


QNDOOOODAAOAoOodDd 


Value 
CO 
OO00S0 
JOHh 
Bi 
GEYER 
EQ1 
boo 
1979-08-17 
MOA aGER, 
16 
ial 
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The XML View tab shows the same parsed records in XML format. 









































<EmpNo type="xs:string’ >O00050</EmpNo> 
<FirstName type="ss:string >JOHN</FirstName> 





<Midinit type="xs:string' >B=</MidInit> 

<LastName type="ss:string >GEYER<=/LastName=> 
<WorkDept type="ss:string >EO1</WorkDept> 
<PhoneNo type='"ss:string >6769</PhoneNo» 
<HireDate type="“s:date'>1979-08-17</HireDate> 
<Job type="ss:string’ >MANAGER=/Job> 

<EdLevel type="xs:int'>16</EdLeval> 

<Sex type="ss:istring >M=</Sex> 

<BirthDate type="xs:date'>1955-09-15</8irthDate> 








__9. Inthe Employee message model, click on the Record element. The first record in the input text 
will be underlined. 


Test Parse Model Test Serialize Model Show properties Show advanced Show allsections Focus on selected Show quick outline Create logical instance 
“a 


Name Type Min Occurs Max Occurs Default Value Sample Test Data 


=| [e| Employee 


(=) eee sequence 


Add a Local 








‘tS. Navigator [si Problems Ey DFDL Test - Parse 2 Eg DFDL Test - Serialize Iie DFDL Test - Trace 








DFDL Test - Parse: Runs the DFDL parser with the provided physical input data and selected message root, and updates the logical instance view with the result of the parse. 
Status: Parsing completed: Thu Jun 02 11:13:51 CDT 2011 





Input 
Data: | /MessageModelingLibrary_brokerfemployees.csy v Message root: Employee (/MessageModelir 
Parsed Input 
Characters 
1 Companyl1,42,125 Street,Winchester,UK 


? "AnAAD " u HR g u " u "HAAS !! "Ano" u eB ot u on -f -ff u "DR u 16 u u u dF -fNa- All i nu 
3 "000020","MICHAEL","L","THOMPSON","BO1","3476","2003-10-10","MANAGER ",18,"M","19786-02-02",94250.00 
4 "000030","SALLY","A", "KWAN", "CO1","4736","2005-04-05", "MANAGER ",20,"F","1971-05-11",98250.00 
Ss. 000050","JOHN","B", "GEYER" ,"E01","6789","1979-08-17", "MANAGER ",16,°M","1955-09-15",80175.00 
6 


"000060". "IRVING" ."F" "STERN" ."D11"."6423"."2003-09-14". "MANAGER ".16."M"."1975-07-07".72250.00 


1:1 Offset: [o | Repeating index: Show line numbers [| Show hex Selection in DFDL Editor = record : <Anonymous> (complex) Range of selection: 38 
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To go to another record in the input text, just change the Repeating Index number. 


DFDL Test - Parse: Runs the DFDL parser with the provided physical input data and selected message, and updates the logical instance view with the result of the parse. 
Status: Parsing completed: Fri Jan 27 06:59:39 CST 2012 
Input 


Data: [/MessageModelingLibrary}employees.csy 7| Browse... | Message: Employee (/MessageModellingLibrary/Employee.xsd) 


Parsed Input 
Characters 


20 "000210", "WILLIAM", "T","JONES","D11","0942","1998-04-11","DESIGNER",17,"M","2003-02-23",686270.00 


" ' " ! ' ' " " " ! " ! " ! 
000220' aw Ba B72! g" : : 9786-03-19" 49840, 00 


",14,"M","1980-05-30",42180.00 
23 "000240","SALVATORE","M","MARINO","D21","3780","2004-12-05", "CLERK Seifs My 2OUe-Uo-31",40760.00 


sJ 
Selection in DFDL Editor Selection in Input 
Selected: record : <Anonymous> (complex) | Repeating index:f]z0] _ | Range in parsed input: 1923 - 2019) | Row: 1 | Column: 33 | Offset: [32 | Length: fo 


__10. Click on any element in the message model to see where it is located in the input text. 















































‘i Employee.xsd a & = © \{(Bi Foi Test - Logical Instance <a a Ea | fl Oo 
EL Ey rs A » Data source: <From 'DFDL Test - Parse’ view> 
Test Parse Model Test Serialize Model Show properties Show advanced Showallsections 3 eee 
_ : at : 7 - Message: Employee (/student/DFDL/workspace/MessageModellingLibrary/Employee.xsd) 
=[Elecord 1 unbounded 
Sale meee : E Tree View {XML View \. 
[e] EmpNo 1 1 : a aaa 
First : 1 <Job xsi: type="xs:string">PRES</Job> 
(el os — <EdLevel xsi: type="xs:int" >18</EdLevel> (=i 
(e] MidInit 1 1 <Sex xsi: type="xs:string">F</Sex> 
1 1 <BirthDate xsi: type="xs:date">1963-08-24+00:00</BirthDate> 
1 1 <Salary xsi: type="xs:decimal">152750</Salary> 
[e] PhoneNo 1 1 </record> 
[el HireNate 1 1 - <record> — 
<EmpNo xsi: type="xs:string">000020</EmpNo> v 
(25. Navigator ([2. Problems (EMMDEDUMestePareustn. [Gj DFDL Test - Serialize) lig DFDL Test - Trace) Oak elas l—Haeonrra 





> 


DFDL Test - Parse: Runs the DFDL parser with the provided physical input data and selected message, and updates the logical instance view with the result of the parse. 
Status: Parsing completed: Tue Jul 23 03:31:08 EDT 2013 


Input 
Data: | /MessageModellingLibrary/employees.csv ’ Encoding (code page): Message: Employee (/MessageModellingLibrary/Employee.xsd) 
Parsed Input 
Characters 7 








1 Companyl,42,123 Street,Winches}e==* 


2 "000010","CHRISTINE","I","HAAS' sora» 2985-01-01", PRES wei0y EF", 1963-08-24" ,152750.00 




















3 "000020","MICHAEL","L","THOMPS Ghee, "3476","2003-10-10","MANAGER ",16,"M","1978-02-02",94250.00 ~ 
4 b 
Selection in DFDL Editor Character Selection In Input — Byte Selection In Input WwW 
Selected: WorkDept : string | Repeating index: 1 | Range in parsed input: 70-75 Row:0 | Column: 0 Offset: 0 | Length: 0 dil 


The parser can be run against other input text by clicking the Browse button in the input section, 
selecting the file, and clicking the Run Parser button. 





C= Navigator fae Problems (©) DFDL Test - Parse 53. ; Ey DFDL Test - Serialize ie DFDL Test - Trace | 


,O 45 6/8 $[S\"4o) 











DFDL Test - Parse: Runs the DFDL parser with the provided physical input data and selected message root, and updates the logical instance if result of the parse. 








Status: Ready 
Input 


ey-le-F| | lessageModelingLibrary_broker/employees.csy na Message root: Employee (/MessageModelingLibrary_broker/Employee.xsd) 


Parsed Input 
Characters 


Company1,42,123 Street,Winchester,UK 

"900010","CHRISTINE", "I", "HAAS", "A00","3978","1995-01-01","PRES ",18,"F","1963-08-24",152750.00 
"900020","MICHAEL","L","THOMPSON","BO1","3476","2003-10-10","MANAGER ",18,"M","1978-02-02",94250.00 
"900030","SALLY","A", "KWAN", "CO1","4738","2005-04-05","MANAGER ",20,"F","1971-05-11",98250.00 
"900050","JOHN","B","GEYER","E01","6789","1979-08-17","MANAGER ",16,"M","1955-09-15",80175.00 
"900060". "IRVING". "F" "STERN" ."D11"."6423"."2003-09-14". "MANAGER ".16."M"."1975-07-07".72250.00 


Offset: [o | Repeating index: fi: ] Show line numbers  [_]Showhex — Selection in DFDL Editor = 'WorkDept : string Range of selection: -1 - -1 
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__11. Select the DFDL Test — Serialize tab 





t=. Navigator ||". Problems Et. DFDL Test - Parse gS. lk DFDL Test - Serialize @ lc) DFDL Test - Trace 


DFDL Test - Parse: Runs the DFDL parser with the provided physical input data and selected message root, and updates the logical instance view with the result of the parse, 
Status: Parsing completed: Mon Sep 05 07:01:59 CDT 2011 
Input 


Data: | MessageModellingLibrary_brokerfemployees.csy *| Browse... | Message root: Employee (/MessageModelli 





Parsed Input 

Characters 
1 Companyl,4d2,1l235 Street,Winchester,UE 

28" O0O0010", "CHRISTINE", "I" "HAAS", "ADO", "3978". "1995-01-01", "PRES Peooe fe Labs Vee 24". Loe 
3 "OO00020", "MICHAEL", "Lb", "THOMPSON" "BOL", "3476","20035-10-10", "MANAGER ",10,"M",°19%0-O2-02",¢ 
4 "QOOOS0", "SALLY", "A" "EKWAN" "COL." 4%a0", "2005-04-05", "MANAGER "240 ,°RF",°19%1-05-11",96250.[ 
5 "ooooSo", "JOHN" UB" "GEYER" "E01" "6799" ,"1979-08-17", "MANAGER ",16,"M","1955-09-15",80175.1 
6 "OOOO60", "IRVING", "F" "STERN", "D111", "6423" ,"2005-09-14", "MANAGER ",16,"M" "1975-07-07", 72250 


__12. Select <From “DFDL Test — Logical Instance” view> for the Logical Instance, using the drop 
down list. 


__13. Press the Run Serializer icon. 


TS. Navigator can Problems a DFDL Test - Parse [Eq DFOL Test - Serialize 23 Tes DFDL Test - Trace rr) Ei Bj | lal 





DFDOL Test - Serialize: Runs the DFDL serializer with the provided logical instance data and selected message root, and displays the resulting physical data. 
Status: Ready 
Input 


Logical instance: §<From ‘DFDL Test - Logical Instance’ view > Browse... | Message root: <none> {<none>) 








Serialized Gutput 


rn 
1 


__14. The serializer creates a text file from the previously parsed message tree in memory. 


Navigator (f Probleme Bl, OFC Test - Parse lg ©) OFOL Test - Trace 

















OFOL Test - Sertaiize: Runs the DDL serializer wth the provided logical stance Gata and selected message root, and displays the resulting pir, 1) Serialization completed successfully. 


Setus. Serialization completed: Thu Jun O2 11:19:14 CDT 2011 





Irgnk 
- Tes: 
Logfces tectenees [ivan CPDL Dest » Legeel Sateen view? “i [Brows + The trace captured while running the OF DL sariskner can be viewed by chching on the Open DDL Trace View toolbar button or bi diching here. 
Seriskred Output 
Characters []Oo not display this message again 
1 Companyl,42,123 Street Winchester .UK ; —— 


2 Q00010,CHRISTINE,1,HAAS,AU0,3978,1995-01-01,PRES,18.F,1963-08-24,152750 
3 000020,MICHAEL,.L,.THOMPSON,801,3476,2003-10-10,MANAGER, 18,.M,1978-02-02,94250 
4 OOU030.SALLY.A.RWAN.CO1.4736.2005-04-05 .MANAGER. 20.F.1971-05-11.98250 
$ 000050, J0HN,B,GEYER,£01,6789,1979-08-17 MANAGER, 16,M,1955-09-15,80175 
¢ 000060 .IRVING.F .STERN.D11.6423.2003-09-14.MANAGER. 16.M.1975-07-07.72250 





Lil Offset: 0 [7) show Ine mumbers [Show nex 


__15. Click the X icon to dismiss the results dialog. 


= 
G) Serialization completed successfully. 


Tips: 


«To view the trace captured while running the DFDL serializer, click the Open DFDL Trace View toolbar butkon, or click here, 


T Do not display this message again 
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The results of the serialization test should appear. The output will now be saved as a file. 


__16. Press the Save to File button (diskette icon). 


Us. Navigator ||*. Problems | [:},. DFDL Test - Parse | Ec 


DFDL Test - Serialize: Runs the DFDL serializer with the provided logical instance data and selected message root, and displays the resulting physical data. 
Status: Serialization completed: Mon Sep 05 07:11:43 CDT 2011 
Input 


Logical instance: [<From '‘DFDL Test - Logical Instance’ view > 7| Browse... | Message root: Employee (/MessageModellingLibrary_broker/Employee.xsd) 


~ Serialized Output 
Characters 


Company1,42,1235 Street,Winchester,UK 
000010,CHRISTINE,1I,HAAS,A0O,39768,1995-01-01,PRES5 «LO,F »1963-06-24,152750 
000020,MICHAEL,L,THOMPSON,B01,3476,2003-10-10,MANAGER ,16,M,19768-02-02,94250 
000030,SALLY,A,KWAN,CO1,4738,2005-04-05,MANAGER ,20,F,1971-05-11,98250 
000050,J0HN,5,GEYER,E01,6789,1979-08-17,MANAGER ,16,M,1955-09-15,80175 
000060,IRVING,F,STERN,D11,64235,2003-09-14,MANAGER ,16,M,1975-07-07,72250 
000070,EVA,D,PULASKI ,D21,7831,2005-09-30,MANAGER ,16,F,2003-05-26,96170 
000090,EILEEN,W,HENDERSON,E11,5498,2000-08-15,MANAGER ,16,F,1971-05-15,89750 
000100,THEODORE,Q,S5PENSER,E21,0972,2000-06-19,MANAGER ,14,M,1980-12-16,86150 
000110, VINCENZO,G,LUCCHESSI ,A00,3490,1986-05-16,5ALESREP,19,M,1959-11-05,66500 
000120,S5EAN, ,0'CONNELL,AOO,2167,1993-12-05,CLERK -14,M,1972-10-18,49250 


Gicucne ethene ctoskihin Eien ee 














Ke OW MOA O Om ftw NH 


_ 








17. Select the MessageModellingLibrary as the parent folder. 
__18. Enter employee_output.csv as the File name. 


__19. Press the OK button. 


Save As 


Save file to another location. 


Enter or select the parent folder: 
MessageModellingLibrary 





MessageModellingLibrary 
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Close the DFDL Test perspective. 
__20. Select the DFDL Test perspective tab in the upper right corner. 
__21. Press the right mouse button. 


__22. Select Close from the menu. 





File Edit Navigate Search Project Run Window Help 























ri & a Ge M~ it~ ~ “37 i ¢ raf (>) 
| Customize... 
| [a] Employee.xcsd Pa Gave As 
EL Ey z e' vit Reset 
Test Parse Model Test Seralize Model Show properties Show advanced Show allsections Focus on selected 
— 7 n Message: Employee (/student/DFDL/workspace/M 
= [e] record 1 unbounded Dock On 
[J = sequence 1 1 Tree View. XML View |v Show Text 
[e] EmpNo 1 1 valuel header = an) 
[e] FirstName 1 1 value? record 5 
[@] MidInit 1 1 value3 record = 
[e] LastName 1 1 valued |_|] ae 
[e| WorkDept 1 1 value5 dca 
record 
le] PhoneNo 1 1 valueé _ 
: : record 
[e| HireDate 1 -. 2001-01 ae 
i 1 —rernirel l _ x 
4 | mT ; 
5. Navigator | (£1 Problems |}. DEDL Test - Parse | [Ej DFDL Test - Serialize 22 ~. [jp DFDL Test - Trace O55 B|/B\EBOoOyY 4 
DFDL Test - Serialize: Runs the DFDL serializer with the provided logical instance data, and displays the resulting physical data. 
Status: Serialization completed: Sat Now 03 14:17:46 EDT 2012 
Input 
Logical instance: | <From 'DFDL Test - Logical Instance’ view> Schema: /MessageModellingLibrary/Employee.xsd 
Serialized Output 
Characters 
1 Companyl,42,1235 Street,Winchester UK “ 
2 OOO010,CHRISTINE,I HAAS ,ADO,3976,1995-01-01,PRES glee? ,l8ba-Ue=-24 152/50 | a 
3 QOO0Z0,MICHAEL,L,THOMPSON,BO1,s47%6,2005-10-10,MANAGER ,10,M,19760-02-02,94250 
4 NNNNaAn SATT¥Y & EWARD MN 479R 2SNNS-N4-NS MAN AGRFR FN F T4¥1-NG-11 GAYSN 2 
@ k 
Selection in Input 
Row: 0) Colurnmn: 0 | Offser: 0 Length: 0 


° & 


__ 23. Close the Employee.xsd tab. 


[5) Employee 


This lab has provided a brief introduction to some of the new capabilities that have been provided with 
the DFDL parser. The DFDL domain should be the parser of choice for all non-XML data formats. 


This is the end of Lab 2. 
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Lab 3 Graphical Data Mapper 


3.1. Introduction to mapping 


IBM Integration Bus Version 9 includes the high performing IBM Graphical Data Mapper (GDM), a newly 
upgraded mapping editor. It allows you to visually map and transform source to target data, and is based 
on common mapping tooling across all WebSphere integration products. GDM is also included in other 
IBM offerings such as InfoSphere® Master Data Management v10, Rational® Application Developer for 
WebSphere Software v8.5 and Rational Software Architect v8.5. It generates a standards-based format 
of the mapping function known as Map Specification Language. 


GDM allows you to apply transformations to single and multiple elements, with support for conditionals (if 
then else), loops (for each), functions and more. It Supports database mapping sources and targets for 
routing and enrichment scenarios, including support for database selects, inserts, updates, deletes and 
the ability to directly access stored procedures. It complements and supports existing transformation 
languages, including the ability to call user defined transformations in Java, ESQL and XPATH. 


In IBM Integration Bus V9, the GDM supports migration of pre-v8 maps. Most sophisticated maps can 


be converted in a single step. The editor provides enhanced feedback about conversion to assist user 
understanding. 


3.2 Preparation — Build the SAMPLE connection 


NOTE: This is the first step required no matter which part of the Mapping lab you plan to build. It 
is used by all further sections of the Mapping lab. 


The Mapping Node uses JDBC to connect to relational databases. The appendix of the lab describes 
the JDBC configuration that is necessary for the Integration Bus Runtime to access the SAMPLE 
database from a Mapping node. 


The first task is to create a Library that will be used as a container for the required database connections 
and any Message Models used by the labs. 


This lab will start from a blank workspace. 
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1. Select File>Switch Workspace Other. 


2. Enter C:\student\Mapping Database\workspace for the Workspace. 


Select a workspace 


IBM Integration Toolkit stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


Workspace: 9 BAe vUT EE) ye MAE vel ets 


[| Use this as the default and do not ask again 








2S: Press the OK button to continue. 


4. — Click on the Go to the Integration Toolkit link to close the Welcome screen. 


Go tome Integration Toolkit /—} 
: la 


The lab will retrieve employee information from the EMPLOYEE table in the SAMPLE DB2® database. 
We therefore need to create a Database Definition project so that the Message Flow can access the 
database. 


The database connection for SAMPLE already exists. So we will connect to it So we can use it. 


a: Click on the Data Source Explorer view to open it. 


a Integration Nodes 2-1 | V2 Data Source Explorer | 2: ~ 7 
4 @2 Integration Nodes 
a <4 IBSNODE 
> fe, default 
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__6. — Right-click the SAMPLE Database Connection, and select Connect from the menu. 





“Disconnect 
Ping... 
Work Offline 
Save Offline 
Rename Fe 
Delete Delete 
Duplicate 
Open SOL Scrapbook 

9 Create EJBs from Tables (1.x-2.x) 


fs Integration Nodes | (HH Dai Properties Alt+ Enter 


ere 
, Stop Simulation 


Edit and Arrange Palette ... 
Run in New Workbench... 






3 BIRT Classic Mode 
ES CNTRYDB [DB2 Ali 





Package... 









Dat 
(=> Classic Models Inc. Sample Database 
G Flat File Data Source Curr 
(= JDBC Data Source Ga 
[> Web Services Data Source 
(=> AML Data Source Dat 
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7. Set the User name to db2admin and Password to db8admin. Click OK. 











type filter text 











Common 

Default Scherna Filter 

Default Stored Procedure F 

Default Table Filter 

Driver Properties 

Version Database: 














Host: 











Port number: 








User name: 


Password: 


("| Save password 


Default schema: 


















































Connection URL: jdbe:db?://localhost:50000/SAMPLE:retrieveMes + 
sagesFromServerOnGetMessage=true 


Test Connection 


. Cancel 
| 


i 








8. |AJDBC connection will be established to the SAMPLE database, and you will see the SAMPLE 
database with a blue “connected” database icon. 


ae Integration Nodes ‘ARB Data Source Explorer ei 
a |(B) @| 


4 (2 Database Connections 
3 BIRT Classic Models Sample Database 
ES CNTRYDB [DB2 Alias] 
ES CUSTDB [DB? Alias] 
ES NEWEMPDB [DB2 Alias] 
oe SAMPLE (DB? for Linux, UNIX, and Windows V9.7) 
= [) SAMPLE 





4 (2 ODA Data Sources 


(= Classic Models Inc. Sarnmple Database 
(=> Flat File Data Source 

(=> JDBC Data Source 

(> Web Services Data Source 
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_: lf you open the twistie next to SAMPLE, you can explore the different catagoried folders of 
database assets and users that you can further explore, with the ability to get all the way down to 
the definitions and contents. All that is needed for now is to establish this connection. 


E ~ i 


BS |e) @| ed | 
r E4 SAMPLE (DB? for Linux, UNIX, and Windows V9.7) 
a{{) SAMPLE| 
» (5) Federated Database Objects 
t+ LQ Groups 
tb [a Roles 
4a [) Schemas 
» BE ADMIN 
> @S NULLID 
» BE sou 
» BE SYSCAT 
» BE SYSFUN 
» BE SYSIBM 
» BE SYSIBMADM 
» BE SYSIBMINTERNAL 
> BE SYSIBMTS 
> BE SYSPROC 
» BE SYSPUBLIC 
> BH SYSSTAT 
> BE SYSTOOLS 
b> (Lo Users 


ie Integration Nodes [' Z 









We can now build our database definition file. 


__10. Start by creating a new library by clicking the New Library... link. Name the new library 
Mapping_Lib and click Finish. 


Application De <a. Patterns Explo ), =e 


Application Development 
Create a new library 

New Application... . P 
A library allows re-usable artifacts to be grouped and managed together. Enter a name for the new library. 
New Integration Service... 





(pu Integration N ‘fps Data Sq) 


es |S) 


(= Database Connections 


— eee . — 
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__11. Inthe Mapping_Lib library, click New, and select Database Definition. 






New 


Application a, ~— = 


New Artifact 
Create a new artifact. 












Message Flow 

EI; Subflow 
Message Model... 
Fe Message Map 

IB& ESOL File 

fe Decision Service 
ij MOQ Service 

Ai Database Service 


Broker Schema 


























oe Integration N 





(=> Database Cr 
ES BIRT Cla 
ES CNTRYE 
Ea CLUSTNF 
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12. 


Since we do not have an existing project to store this, click New to create a new database 
design project. Name this SAMPLE. 


| (2) New Database Definition File 
Create a database definition file 


Specify the database type, version and the data design project that will contain the database definition file 


Database: 


Version: 


Create a data design project 


Specify a basic definition for the new project. This project stores data design objects. |/ 


Project name: [Sawrce] | 


Use default location 











Location: | C:\student\Mapping_database\workspace\ SAMPLE | | 








Browse... 
Working sets 


Add project to working sets 


Working sets: 





Data Sources 


dassic Models Inc. Sarnmple Database 


lat Cirle Miata Gane en 














Rast Pb SPR 1 


__13. Click Finish. 
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14. 


The Database Design project field has now been populated with the SAMPLE project. Select 
V9.7 from the Version drop-down box. 


| (2) New Database Definition File - 


Create a database definition file 


Specify the database type, version and the data design project that will contain the database definition file. 


Data design project: | SAMPLE 
Database: 


Version: 





=e 
15. Click Next. 
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__16. Highlight the SAMPLE connection that we have connected to and click Next. 


Drevoomencmeenie LO St~—~<C~is‘SOC 


select Connection 
Select an existing connection. 


Connections 





* Properties 
Property Value 
Name SAMPLE 
Description 
Category Database Connections 
Database SAMPLE 
JDBC Driver Class comJbm.db2,jcc.DB2Driver 
Class Location CAIBM\SDPShared\ plugins\com.ibm.datat... 


| 
Panne ctinn LID tale lb flee lb et CA PC AKAD Coe nteins 


Finish 
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__17. Select the ADMIN schema (the SAMPLE database was created under the ADMIN schema). 
Click Finish. 


10) New Database Definition File Se 
Select Schema 


Select schema(s) to reverse engineer. 


Apply name filter (? = Any character, * = Any string): 


Select objects: 
iz) ADMIN | 
[|] SOU 

[P| S¥YSCAT 

[| SYSFUN 

[| SYSIBM 

[| SYSIBMADM 
| SYSIBMINTERNAL 
[| SYSIBMTS 
| SYSPROC 
| S¥SPUBLIC 
[| SYSSTAT 





__18. The Database Design project has now been created. It has been created as a separate project 
under the Independent Resources in the navigator. 





Application Development New... 


4 BA Mapping_Lib 
(New...) 
F Independent Resources 
4 |S SAMPLE | 
3) SAMPLE.dbrm 
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__19. Right-click the SAMPLE project and select “Add project to existing container’. 


a P| } int ntegration | 











, 
File Edit Navigat 
wil L i 
—— Convert To Application or Library r 





Migrate 
ne) | oo 
\\_ 4 BA Mapping_Lil = 
J (New...) 
* . ! dependen Paste 
4 (= SAMPLE Delete 
| 2AM Move... 
Rename... 


__20. Select the Mapping_Lib library and click OK. 


(y) Add project to existing container “ 


Select an Application, Library, or Integration Service into which the project will be included. 
The project will remain on the workspace, 


BA Mapping _Lib 


The following projects will also be included as they are 
referenced by the checked projects. 
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__21. The Database Definition file, SAMPLE.dbm, will now been seen in the Other Resources folder 
in the Mapping_Lib library. 
Application Development £3 “2, Patterns Explorer 


Application Development 


4 Bi Mapping_Lib 
a (= Other Resources 
4 lg SAMPLE 
3g) SAMPLE.dbm 


_ 22. The database definitions are now available to the application and do not need to be changed 
further. If it is open, close the SAMPLE.dbm editor. 


3.3 Using a select ina map 


This lab will use the standard DB2 SAMPLE database (EMPLOYEE table) and a Message Model based 
on a COBOL copybook. 


An incoming message in COBOL format will be used to retrieve employee information from the 
EMPLOYEE table. This information will be used to populate several fields in the COBOL message, 
before being output from the message flow. 


The lab will show you how to build the Database Definition, Message Model, Message Flow and the 
Mapping Node that will be used to retrieve the database row and build the outgoing message. 


We will now create a new Message Model using the DFDL importer, based on an existing COBOL 
copybook. The message model will be defined in the Mapping_Lib library. 


Be sure you have completed the steps in Section 3.2 to build the SAMPLE database definition. 


_ Ns Highlight the Mapping Lib library name, and then click New and select Message Model.... 








Application Development Wee Start building 
4) Mapping_Lib New Artifact 
Oo a ommaaa Bai Message Flow 
lam SAMPLE 
2m] SAMPLE.dbm Subflow 


Fr Message Map 
ESQL File 

ce Decision Service 
Wii MOQ Service 


AT Database Service 
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2. Click the COBOL radio button, and click Next. 


——- 


Create a new message model file 


Select the message model type or format 








ML 
() SOAP XML AML data for use in Web Services, 
(Other XML All other XML data. 


Text and binary 
() CSV text Comma Separated Values data, a delimited text format commonly used as an export 
format by spreadsheets and databases. 


Text data formats where delimited fields are grouped into records. 
Data for COBOL programs 


Es Data for © programs 
() Other text or binary All other text or binary data formats. 


Enterprise Information Systems 


(-) SAP Data from SAP systems including [Doc and BAPI 
| (-) Siebel Data from Siebel systems 

() PeopleSoft Data from PeopleSoft 
| () JD Edwards Data from JD Edwards systems 

Other 

() CORBAIDL Data from CORBA 

() Database record Records from relational databases 

() MIME Data for extended email format 
| (-) IBM supplied Predefined data format 














| «< Back i: 5 Cancel 
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__3. Accept the default selection (Create a DFDL schema file by importing a COBOL copybook 
program) and click Next. 


COBOL 


Choose how you would like to create your COBOL message model. 


Integration Bus requires a message model in order to parse, serialize and validate COBOL data. A message model 
also speeds up development of your integration applications by enabling ESQL content assist and graphical maps. 


(@) Create a DFDL schema file by importing a COBOL copybook or program. 
() Import or replace the IBM supplied DFDL schema property defaults for COBOL. 
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_ 4. Ensure the Application Name is set to Mapping_Lib. 


— — 
ci ie. «@ : 


New Data Format Description Language Schema (DFDL) From a Source 
Select the type of data definition from which to import and create a DFDL schema. 


(5) New DFDL Schema a 


Application or Library: 


Folder: 





DFDL scherna filename: Fry ployee.xsd 
Select source file from workspace: 


<= Mapping _Lib 
— SAMPLE 


WO Select source file from outside workspace: | 


Location JC\student\Mapping_database\resources\Employee.cpy 


(¥| Overwrite existing DFDL schema file 


\¥ Copy source file into the ‘importFiles' directory of the ta rget project 








_ 0: Click “Select source from outside workspace’, and set the location of the file to 
c:\student\mapping_database\resources\Employee.cpy (you can use the Browse button) 


6. Click Next. 
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_ 7. In the Source Structures panel, click on EMPLOYEE. 


structure and Message Selection 


Select the 01 level COBOL structures to import as messages. 


Source structures Imported structures 
sTUASITE 











Finish 
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__ 8. You can then click the right arrow in the middle to move it to the Imported Structures pane. 
Click Next. 


® New DFDL Schema 


| Structure and Message Selection 
Select the 01 level COBOL structures to import as messages. 


Source structures Imported structures 
EMPLOVEE 
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__9. — Accept all the default values and click Next. 


© New DFDL Schema (LS eo 


Import Options 
Optionally override defaults for generation of DFDL schema from COBOL import. 


Default values 
Specify these options if you want default values to be created for each field. 
(Mv) Create default values from initial VALUEs 


Null values 
Specify this option if you want the processor to recognize fields as logically null when the value is SPACES, HIGH-VALUES or 
LOW-VALUES. More... 

Recognize null values for all fields 


al 


strings: SPACES 


Pad character 
Specify the character to be used by the processor when padding field values on output, and when trimming field values on inpu | 


























strings: SPACE 
Value constraints 


Specify this option if you want fields to be given value constraints whenever possible, More... 
Create value constraints from level 88 VALUE clauses 
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__10. Accept all the default values and click Finish. 
© New DFDL Schema 


| Import Options 


Specify settings that describe the COBOL data as it appears on the target system. 


The importer compiles the supplied COBOL file in order to create the DFDL schema. Some compiler options may be changed on1 
A full set of compiler options may be found in the Preferences settings here. 


Specifying target platform affects selection of the encoding options. 
Platform: | Win32 
Encoding options 


‘@) Dynamic - provided to the processor by the application at runtime 
(©) Fixed - provided below 


Encoding (code page); | ISO-8859-1 























Floating point format IEEE Non-Extended 
Byte order; (@) Little endian Big endian 

External (zoned) decimal 

[| Use EBCDIC sign characters with ASCII numbers 

EBCDIC encoding {code page) for sign characters()): | 

Compiler options 
QUOTE: @) DOUBLE (|) SINGLE 
TRUNC: @ STD ©) OPT © BIN 
NSYMBOL: @) NATIONAL (|) DBCS 


Restore Defaults 
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__11. The new Message Model has now been created, and will look something like the screen capture 
below. Note that DFDL uses the standard XSD model, so the created file is called Employee.xsd. Note 
that all hyphens in the COBOL copybook have been converted to underscores in the schema. 


You can explore the schema by clicking on various elements in the left pane; element details will appear 


in the right pane. Further information on the DFDL Message Modeling tools is provided in other lab 
guides. When you have finished looking at the Message Model, close the schema editor. 


FES = 


& EF 
Test Parse Model Test Serialize Model Hide properties Show ceil Show all sections Focus on selected Show quick outline Create logical instance 


- ZA : : 
v Messages Alagtt+ x| HRB =) Representation Properties 
A message Is a global element that models an entire document of data. EMPLOYEE (Element) @ 


Name Type Min Occurs | Max Occurs | Default Value || Sample Value a % | (S| & 4 


=) [e] EMPLOYEE EMPLOYEE Property Value 
=) ee sequence Comment 
[e] EMPLOYEE_NO <PICX_string> 
{e] FIRST_NAME <PICX_string> 
{e} MID_INITIAL <PICX_string> 
{e] LAST_NAME <PICX_string> 
le} WORK_DEPARTMENT <PICX_string> 
[e] PHONE <PICX_string> 
{e] JOB <PICX_string> 
fe] ED_LEVEL <PIC9-Display-Zoned_short> 
[e] SEX <PICX_string> 
{e] SALARY <PIC9-Display-Zoned_decimal> 
{e] BONUS <PIC9-Display-Zoned_decimal> 
{e] COMMISSION <PIC9-Display-Zoned_ decimal> 
Add a Local Element 


4 General 
Encoding (cod, <dynamically set = 
Byte Order © <dynamically set = 
4 Content 


Length Kind — implicit 








4 Occurrences 
Min Occurs | 1 
Max Occurs | 1 
4 Delimiters 
Initiator = <noinitiator> —[,...] 
Terminator ©, <no terminator> (us) 


ee ee ee ee ee ee ee ee ee 





__12. The navigator will now show the complete library, with the database and Message Model 
schemas. 


| Application Development Nd 


4 Bi Mapping_Lib 
4 (=. Schema Definitions 


4 £& (default namespace) 
([a) Employee.xcsd | 
>» BR http://www.ibm.com/dfdl/CobolDataDefinitionFormat | 
a (= Other Resources 
4 log SAMPLE 
2m] SAMPLE.dbm 
> > importFiles 
> log 
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__13. Create a new Integration Bus Application by clicking on the New link, and then select “Start by 


creating an application’. 























Application Development New... 


=, Mapping_Lib New Artifact 
CS. Schema Definitions 


Message Flow 


Ge (default namespace) 
Elz Subflow 


[G) Employee.xsd 
fi http://www.ibm.com/dfdl/Cobq Message Model... 


he, 
US Other Resources 





frat Message Map 


lag SAMPLE : 

ig) SAMPLE.dbm BE ESOL File 
iis EE Decision Service 
& log Wij MOQ Service 


Fly Database Service 


4 Start by creating a library 
§2 Start from WSDL and/or XSD files 


4 | m - —_ 





= : ies 7 ie : * oI = 
da Integration —h PE Data Source | =|" Start by discovering a service 


rear 


__14. Name the new application Mapping _DB_ Read and click Next. 


| (i) New Application 


Create a new application 
An application ts a deployable container that provides isolation at runtime. Enter a name for the new 


application. 


Application name 
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__15. Check the Mapping_Lib library to reference from the new Application. Click Finish. 





10) New Application 


Create a new application 


Specify dependencies on libraries. 








Select existing libraries to reference from the new Application: 


The following libraries will also be included as they are referenced by the checked libraries. 











a 





__ 16. This will result in the following: 























Application Development 


4 |i] References 
4 Bi Mapping_Lib 
4 (=. Schema Definitions 
> EB (default namespace) 
> GB http://www.ibm.com/dfdl/CobolDataDefinitionFormat 
a (@ Other Resources 
> Log SAMPLE 
> [S importhiles 
> Ge log 
[* (New...) 
4 Bi Mapping_Lib 
» (S. Schema Definitions 


» (4 Other Resources 





We will now create the message flow which will use the database definition and the Message Model. 


We will create a simple flow with just an MQInput, MQOutput and a Mapping Node. 
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__17. Click the New link under the Mapping_DB_Read Application and select Message Flow. 





Application Development 


Mapping DB_Read 
[Ry] References 
=A, Mapping _Lib 

(= Schema Definitions 
fs (default namespace) 
Ee http://www.ibm.com/dfdl/CobolDat 

(= Other Resources 
lag SAMPLE 
(=> ImportFiles 





(= Other R Create a new artifact, 
BNE Message Flow 
Subflow 
Message Model... 
ee cmeaealdes ie Message Map 





__18. Name the message flow RetrieveEmployee and click Finish. 


oO New Message Flow Sen) 


Create a new message flow 


Select a container for the new message flow 


Container: Mapping _DB_Read 
Message flow name: J RetrieveEmployee | 
Flow organization 
Use default broker schema 
(default broker scherna) 
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__19. Drop an MQ Input node onto the flow editor. 
On the Basic tab, set the MQ Queue Name to MAPPING.READ.IN 


*RetrieveEmployee.msgflow éi 
<| <2 Palette 

BV & : 

2 Favorites 

[> WebSphereMQ = <s 


(|) MQInput = 
fa] MQoutpat 


vane 
ray MOQHeader 


[)[: MQOptimizedFlow... 


ams JMS 

Lz HTTP 

Lag» Web Services 

(ol SCA 

a 


Graph | User Defined Properties 
(| Properties 2:5 2! Problems| 5= Qutline| 44] Tasks| FE Deployment Log 


I MQ Input Node Properties - MQ Input 
Pay 
| 
Input Message Parsing Queve name* 9 MAPPING.READIN 
Parser Options 
Advanced 
Validation 





__20. Onthe Input Message Parsing tab, use the drop-down list to set the Message domain to 
DFDL. Click the Browse... button next to Message. 


| Properties &3 », [£) Problems| 5= Outline) 4) Tasks| FE] Deployment Log ee “OO 


I= MQ Input Node Properties - MQ Input 


Basic 
Input Message Parsing | Message domain [J 0FDL: For binary or text messages with a Data Format Description Language schema + 





Parser Options 


Message model <DFDL schema files in Applications and Libraries> 
Advanced 
Validation Message | 
Security 
Stance Physical format 
Monitoring 


Note for the DFDL domain, the Message Model is greyed out. In this case, the message we 
select will be available in the DFDL Schemas folder of the Mapping_Lib library. This is available 
to this Application because of the library reference. 
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__21. Select the EMPLOYEE message and click OK. 


(D DFDL Message Selection 


DFDL Message Selection 


Select a message from a DFDL schema file in a Library or Application 


Filter message names (? = any character, * = any String): 


Select a message: 
4 Bi Mapping_Lib 
DFDL Schemas 


Physical Location: 


Library: =, Mapping_Lib 
Path: [=> Employeexsd 
Namespace: fm {} 











_{£) Problems| G= Outline| 4] Tasks| FS Deployment Log raevce 
l= MQ Input Node Properties - MQ Input 


i 


Input Message Parsing = Messagedomain  DFDL: For binary or text messages with a Data Format Description Language schema + 


























Parser Opti 
colada Basta Message model | <DFDL schema files in Applications and Libraries> 














Message {EEMPLOYVEE 


























Physical format = 
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__22. Drop an MQ Output node onto the flow editor. Set the Queue name to MAPPING.READ.OUT 


*RetrieveEmployee.msgflow 3 
4 2 Palette 

by & a 
(at Favorites 

[> WebSphereMQ = <2 7 

(|, MQInput = 

il] MQOutput — —— 

ee? MQReply MQ Input 

i, MQGet 

i) MQHeader 


i 





[lif MQOptimizedFlow... 
ams JMS 
(za. HTTP 


UL Web Services ii 
Graph | User Defined Properties 





‘© pre perties £3», [fi Problems == Outline 42) Tasks | FE] Deployment Log a. od 


i] MQ Output Node Properties - MQ Output 


Description 
Queue manager name 
hisscsss mm 
Queue name 


Validation 
Monitoring 





2 Browse MQ Services... 





MAPPING.READ.OUT 


| = 


__23. Fromthe Transformation drawer, drop a Mapping node onto the flow editor between the MQ 
Input and MQ Output nodes. 









=n] *Ret fal “VELMpPlOvee. msgtiov x " 





| 4&2 Palette 
Lag Web Services * 
[ol SCA 
(gi: WebSphere Adapters -— 
+ Routing 
(rat NET 
(4 Transformation << 
™ .NETCompute 
i=; Mapping 
43) XSLTransform 
ge Compute 
2 JavaCompute 
ag. PHPCompute 





sels 
MQ Ips [Mapping] MQ Output 





-_ 


Graph | User Defined Properties 
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__24. Double-click the Mapping node to open the Mapping wizard. The first screen specifies the 
Application name and map name; accept the defaults and click Next. 


Specify a new message map file 


Select map type, container, name, and broker schema for the new map. 


Type of map that you want to create: 
(@) Message map called by a message flow node 
Submap called by another map 
Container: | Mapping_DB_Read 
Map name: RetrieveEmployee_Mapping 
Map organization 
Use default broker schema 


Schema: | (default broker schema) 
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__25. Expand the available map inputs and outputs, and select EMPLOYEE from the Mapping_Lib 
library for both the input and output. Click Next. 


select map inputs and outputs 


Creates a map that can contain message inputs and outputs with the Properties folder. Optionally, database operations, message 
headers, and LocalEnvironment can be added to the map after creation. 




















Filter map input names (? = any character, * = any String): Filter map output names (? = any character, * = any String): 


Select map inputs Select map outputs 
Mapping_DB_Read 
=, Mapping_Lib 4 BAMapping_Lib 
-> DFDL and AML Schemas j= DEDL and AML Schemas 
[v7] cate EMPLOYEE {1 


Physical Location: 


Library: =i, Mapping_Lib 
Path: (= Employeexsd 
Namespace: fA {} 
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__26. Select the Output domain to DFDL. Click Finish. 


>elect the domain to create the output 


Set the output domain of main map called by a message flow node 

















Qutput domain: | DFDI 














__ 2/7. The Map Editor will now open. The basic inputs and outputs are available (based on the 
Employee.xsd Message Model). The message properties have been mapped automatically, but no other 
mappings have been done at this stage. 





[= RetrieveEmployee_Mapping 



















































































+RetrieveEmployee_Mapping rs ol | | |e | x | ef & | fa fe fh | 
la 1: Message Assembly EMPLOYEE la Pas Message Assembly EMPLOYEE 
| $e <Click to filter...» > Click to filter...> 
, a , Mae les =e 
@ gf! Properties [0.1] PropertiesType os _| pf] Properties [0.1] Properties Type 
a ge] EMPLOYEE [1.1] EMPLOYEE | afl EMPLOYEE pan, Micomsdenadase 




















Lab 3 — Graphical Data Mapper Page 123 


IBM Software 


__28. Wenow need to add a database selection input, so that we can retrieve employee information. 


Click on the Database icon on the top row of the map editor, as shown. If you are not sure which icon tt 
is, hover over it, and it will show the text “Select rows from a database”. 





[= RetrieveEmployee_Mapping 


~RetrieveEmployee_Mapping ae Cl |e i = [=k Be ae ea| & 
= ne: Message Assembly EMPLOYEE = [as Message Assembly EMPLOYEE 
= «Click to filter...> = <Click to filter...> 
EC= as : eee : 
4] gf] Properties [0.1] PropertiesType ss ‘Gi gel Properties [0.1] PropertiesType 
= &&] EMPLOYEE [1.1] EMPLOYEE + gf] EMPLOYEE [1.1] EMPLOYEE 


This will open the “New Database Select” window. 


__29. The Database Select window is the primary tool that is used to tell the Mapping node which 
database table to access, and what query to perform against the selected table. 


In this window, make the following selections: 


i. Inthe left-hand pane (Choose the columns to include), select the EMPLOYEE 
table. If you expand the EMPLOYEE table, you will see that all columns have 
been automatically selected. You can deselect any of these if you wish, but leave 
them all selected for this example. 


li. Inthe “SQL where clause” pane, remove the default contents “1=1”. 


li. | From the Table columns pane, drag and drop the EMPNO column onto the “SQL 
where clause’. 


iv. From the Operations pane, drop an “=” onto the “SQL where clause” (or you can 
type it manually). 


v. From the “Available inputs” pane, expand the EMPLOYEE item, and drop the 
EMPLOYEE_NO onto the “SQL where clause”. Note that this action will generate 
the SQL clause “EMPLOYEE.EMPNO=?”. The “?” is a reference to the fully 
qualified value shown in the field below as an XPath expression: 
$MessageAssembly/EMPLOYEE/EMPLOYEE_NO 


Alternatively, in more complex scenarios, you can construct your own XPath 
expressions in this field. 


vi. Click OK. 
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Choose a database to select from Define a where clause 


Select a database available to the map, or obtain The where clause is used to extract only those rows that fulfill a specified condition, which ts often the 
a different database. value of a key column in the database table. The value can come from other inputs in the map. The 


expression must evaluate to a boolean. 
SAMPLE ~*| Add database... 


Table colurnns | Operator: Available inputs for colurnn values 


Choose the columns to include Be ADMIN | NN Pol $MessageAssembly 
You must choose at least one column. FA EMPLOYEE | be] Properties 
AA eo. 
fw 22 ADMIN = EMENO te] EMPLOYEE 
FR CL SCHED A Al Di le] EMPLOYEE_NO 


— FA ay [e] FIRST_NAME 


E 

| fe] MID_INITLAL 
= <= EMP PHOTO A fe] LAST_NAME 

[| FS EMP_RESUME | = , [e] WORK_DEPART? 
[EB PROJECT E HIREDATI : [e] PHONE 

[=] FE PROJACT E | [e] JOB 

ES EMPPROJACT A fe] ED_LEVEL 
[=] ES ACT | [e] SEX 

[™] FS IN_TRAY | ir 


[Im] EA ORG —————— 
[=] ES STAFF SOL where clause 


[el FA SALES "ADMIN.EMPLOYEE.EMPNO = ? 
[el] FS STAFFG 
™ ES EMPMpc 
























































+ Classify SQL warning 
Place holder XPath expression 


| ? §MessageAssembly/EMPLOYVEE/EMPLOVEE_NO 





__ 30. Wehave now added the input selection for the SAMPLE database, as highlighted below. 


[= RetrieveEmployee_Mapping 


+RetrieveEmployee Mapping  ! | > Jo| &| SF S| Bis S| 










































































|=) PLS Message Assembly EMPLOYEE = [8 Message Assembly EMPLOYEE 
| <Click to filter...> $e <Click to filter...> 














@ gf! Properties [0.1] Properties Type ee) I Fe Properties — 1) deel ; 


| 83 Select from SAMPLE 
=> <Click to filter...> 


ce Fe ResultSet [0..*] Result Set Row 
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__31. Note that adding the database input selection has also created a default mapping function for 
us. To complete the selection, highlight the “Select” map icon, and drag and drop it onto the 
EMPLOYEE output message. 


[= RetrieveEmployee_Mapping 








+ RetrieveEmployee_Mapping rs > | |e {ie | 4 | a S| El 2a Be fh se | 


=| P43 Message Assembly EMPLOYEE = [ef Message Assembly EMPLOYEE 


=> <Click to filter...> => <Click to filter...> 












































ge! Properties Properties ype L 4 afl Properties ‘(0..1] Properties Type ; 


| de] EMPLOYEE [1.1] EMPLOYEE 














fH gel EMPLOYEE EMPLOYEE 








=) 95] Select from SAMPLE 
=> <Click to filter...> 


. El 
Ge Fg? ResultSet (0..*] Result Set Row ____ “E)Select ~~ 





This results in the following mapping. 


[= RetrieveEmployee_Mapping 








+RetrieveEmployee Mapping fl g@| | Jo | ¥&| = S| fo fe fo | 
| = oe Message Assembly EMPLOYEE lE [Pas Message Assembly EMPLOYEE 
| = «Click to filter...> | = < Click to filter...> 
fH 2! Properties [0.1] PropertiesType | | Move " | pfl Properties [0.1] PropertiesType 













& fe] EMPLOYEE [1.4] EMPLOYEE fH be] EMPLOYEE [1.1] EMPLOYEE 

















|e 2H Select from SAMPLE 
=> <Click to filter...> 


fel Eg} ResultSet wv] Result Set Row 


ca) 


Allows you te perform transformation using the result 
set from a successful database select. You may connect 
this transform with AML inputs and outputs. 


Select does not perform any transformation. You must 
transform the input and output elements within the 
nested map. 

Click here to edit the nested map. 


| Do not show again 


Page 126 Discovering what is new in IBM Integration Bus v9.0 


IBM Software 


__32. Tocreate the precise mappings that we need, click the “Select” transform name on the map 
icon. This will open a local map which will contain details of all available fields for input and output. 


Click the Auto Map button to automatically generate the required mappings. Note the element names 
are quite different from the database EMPLOYEE table (the input) to those generated from the COBOL 
copybook (the output). 


(Hover over the icon, and it will show the text “Automap input to output”). 





l=} RetrieveEmployee Mapping * gf EMPLOYEE 


+ RetrieveEmployee_Mapping s? | lo le] | a be fh a 
a aif 

=] ® ResultSet [0..*] Result Set Row = fe) EMPLOYEE EMPLOYEE 

=> <Click to filter...> => <Click to filter...> 
25 EMPNO [1.1] CHAR [e] EMPLOYEE_NO [1.4] <PICX_string> 
§ FIRSTNME [1.1] VARCHAR [e] FIRST_NAME [1.4] <PICKX_string> 
§ MIDINIT [1.1] CHAR fe] MID_INITIAL [1.4] <PICX_string> 
B LASTNAME =‘ [1.4] VARCHAR LAST_NAME [1.4] <PICX_string> 
B WORKDEPT [1.4] CHAR [e] WORK_DEPARTMENT [1.1] <PICX_-string> 
B PHONENO ~—‘[1.1] CHAR [e] PHONE [1.4] <PICK_string> 
§ HIREDATE [1.1] DATE [e] JOB [1.4] <PICKX_string> 
B JOB [1.1] CHAR fe] ED LEVEL [1.1] <PIC9-Display-Zoned_short> 
B EDLEVEL [1.1] SMALLINT [e] SEX [1.4] <PICX_string> 
B SEX [1.1] CHAR o— [eB] SALARY [1.1] <PIC9-Display-Zoned_decimal> [i]. 
B BIRTHDATE [1.1] DATE [e] BONUS [1.1] <PIC9-Display-Zoned_decimal> 
B SALARY [1.1] DECIMAL [e] COMMISSION [1.1] <PIC9-Display-Zoned_decimal> 
A BONUS [1.1] DECIMAL 
A COMM [1.1] DECIMAL 
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__ 33. Onthe Auto Map window, check the “Create transforms when the names of inputs and 
outputs are more similar than” checkbox. 


Set the percentage match to 40% (this is required because the input and output field names are 
significantly different). 


Click Next. 


Automatically map inputs to outputs 


Choose the options to automatically map the selected input and output elernents. 
Click Next to select the transforms to create, or click Finish to create the transforms for all the matching elernents. 
Mapping Scope — 

(@) Map all simple descendants of the selected elements 

(| Group transforms into nested maps 

(-) Map the immediate children of the selected elements 
Name Matching Options 

[| Case sensitive 

Alphanumeric characters (Letters and digits only) 
Mapping Criteria — 

Press Fl for more information when the names of inputs and outputs satisfy more than one criterion. 


Create transforms when the names of inputs and outputs are the same 


("| Create transforms when the input and output names are matched to synonyms defined ina file 


Browse... 


zz a ee 





Page 128 Discovering what is new in IBM Integration Bus v9.0 


IBM Software 


__34. The next window will show you the field mappings that have been automatically created, using 
the 40% similarity figure. Note that all fields have been mapped correctly. Click Finish. 


Select transforms to create 


All input and output elernents that satisty the previously chosen options are listed. To deselect an output, clear its check box. 





and click Edit, or double-click the row. 


Transforms found : 


Transform Outputs 
a |W] [oS Message Assembly 
(| @] EMPLOYEE 

fe] BONUS 
le] COMMISSION 
[e] ED_LEVEL 
[e] EMPLOYEE NO 
[@] FIRST_NAME 
[e] JOB 
[e] LAST_NAME 
[é) MID_INITIAL 
fe] PHONE 
[e] SALARY 
[e] SEX 
[e] WORK_DEPARTMENT 


Transforms found 1? 


Transforms selected 1? 


Input matches found 


Input matches selected 12 


Transform Inputs 


BONUS (Select from SAMPLE/ResultSet) 
COMM (Select from SAMPLE/ResultSet) 
EDLEVEL (Select from SAMPLE/ResultSet) 
EMPNO (Select from SAMPLE/ResultSet) 
FIRSTNME (Select from SAMPLE/ResultSet) 
JOB (Select from SAMPLE/ResultSet) 
LASTMIAME (Select from SAMPLE/ResultSet) 
MIDINIT (Select from SAMPLE/ResultSet) 
PHONENO (Select from SAMPLE/ResultSet) 
SALARY (Select from SAMPLE/ResultSet) 
SEX (Select from SAMPLE/ResultSet) 
WORKDEPT (Select from SAMPLE/ResultSet) 


To deselect an input, select its row =, 


Input count 


ee ee ee ee ee ee 
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__ 35. The local map has now been completed, and all input fields from the database result set have 
been mapped onto the output EMPLOYEE record. 


Click “Up a level” (the yellow arrow in the top right). 


[= RetrieveEmployee Mapping * df) EMPLOYEE 





~RetrieveEmployee_Mapping , m1 (>| Rl] s S | fo BS fa | BS E 
= 2 ResultSet [0..*] Result Set Row & pf} EMPLOYEE EMPLOYEE 


+i 


=e <Click to filter...> = <Click to filter...> 


22 EMPNO [1.1] CHAR in Move + [e] EMPLOYEE_NO [1.1] <PICX_string> 
8 FIRSTNME [1.1] VARCHAR wld [= Move ~ [e] FIRST_NAME [1.1] <PICX_string> 
CAT [e] MID_INITIAL [1.1] <PICX_string> 
ribacmins abs SE [e] LAST_NAME [1.1] <PICX_string> 
§ LASTNAME [1.1] VARCHAR a! Move ~ [e] WORK_DEPARTMENT [1.1] <PICX_string> 
5B WORKDEPT [1.1] CHAR my “| Move ~ le] PHONE [1.1] <PICX_string> 
av SM [e] JOB [1.1] <PICX_string> : 
= Ove ¥ 
aid i die ' [e] ED_LEVEL [1.1] <PIC9-Display-Zoned_short> 
§ HIREDATE [1.1] DATE [e] SEX [1.1] <PICX_string> 
ay 
8 JOB [1.1] CHAR + ‘El Move ~ [e] SALARY [1.1] <PIC9-Display-Zoned_decimal> 
§ EDLEVEL [1.1] SMALLINT wal "| Move + le] BONUS [1.1] <PIC9-Display-Zoned_decimal> 
“oA [e] COMMISSION [1.1] <PIC9-Display-Zoned_decimal> 
B SEX [1.1] CHAR bv El Move ~ 
§ BIRTHDATE [1.1] DATE 
av 8 
B SALARY [1.1] DECIMAL *. _E)Move + 
oy 8 
§ BONUS [1.1] DECIMAL oY Move + 
av El 
f COMM [1.1] DECIMAL o _“E]Move + 
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__ 36. Please note that here we can add a map function to handle database failure by right clicking on 
‘Select’ and choosing ‘Handle Failure’. The screen shot below is given for reference only. 

















Redo 


Revert 


Cut 





Copy 
Paste 


Delete 


Create Conn 
Auto Map 









Unde Auto Map 


tion 


Change transform 


Ctrl+% 
Ctrl+C 
Ctrl+V 















Database 





























Edit 






Expand All 
Sort Transforms 


View 


Show In 


Preferences 


rr 


__ 37. Save (Ctrl+S) and close the map. soa 


*RetrieveEmployee.msgflow 
Fes RetrieveEmployee_Mapping 


+ RetrieveEmployee_Mapping i“ } 


=> «Click to filter...> 


BF] Properties (0.1) Properties Type 
fl ge] EMPLOYEE 





[1.1] EMPLOYEE 








9H Select from SAMPLE 


=> <Click to filter...> 









E@ ResultSet Result Set Row 
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ia) Ey EY oe” of” A) 





| {i SiMeves]}- —— 


fe AE Select + {— 


Select from Database 
Call Stored Procedure 
Call User Defined Function 


Insert into Table 
Update Table 
Delete from Table 


Handle Failure 


el Message Assembly 


> <Click to filter...> 


ir fe] Properties 
bel EMPLOYEE 


EMPLOYEE 


[0.1] PropertiesType 
[1.1] EMPLOYEE 
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__ 38. Finally, connect the nodes as shown, and save the flow. sia a: 





p— 
MQ Input oping) = MQ Output 


3.3.1. Deploy and test the application 


__ tk First, to ensure your new application does not interfere with any other deployed application, 
delete all deployed flows from the default Integration server. In the Integration Node view, right- 
click the default Integration Server and select Delete All Flows and Resources. 


| “Fo integration Node mm » Te Data Source Explor — OF ES cht eta a ES Problems 
A 






































pO Pre 
a Gea Integration Nodes 
a ¢ IBSNODE 
(="=2 














Deploy ... 


Stop 
Refresh 























3) AMI Flows And Resources 


2 Integration Server 


Delete h 






¢ & & it 


Launch Debugger (Port is 0) 
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2. In the Applications view, highlight the Mapping_DB_ Read application, and drag and drop it onto 
the default Integration Server (or right-click the application and select Deploy from the context menu). 


Application Development New... 


Mapping DB_Read 
Ee Flows 
RetrieveEmployee.msgflow 
- Maps 
> RetrieveEmployee_Mapping.map 





3: The deployed application will look like this. Note that the Mapping _DB_ Read application 
contains the RetrieveEmployee message flow and the RetreveEmployee_ Mapping map. It also contains 
the library Mapping _Lib, which contains the required message and database schemas. 


a Integration Nodes i: ie Data Source Explorer! 5 a 
| 4 2 Integration Nodes 
a <4] IBSNODE 

» Ae Configurable Services 
F f= default | 
4 3) Mapping_DB_Read 
RetrieveEmployee 
“= RetrieveEmployee_Mapping 





4 Bi Mapping_Lib 
Employee 
IBMdefined’CobolDataDefinitionFormat 
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_ 4, In this example, we will use RFHUtil to send an MQ message to the application. Open an 
instance of RFHUtil from the desktop, use the drop-down boxes to set the Queue Manager Name to 
IIB9QMGR, and set the Queue name to MAPPING.READ.IN using the drop-down box. 

Click Open File, and open the file 


c:\ student \ mapping_database \ Read \ data \ Employee.Cobol.dat. 


File Edit ea Read Write View IRds | | 
Main |Data |MQMD|PS |UsrProp|RFH | PubSub|pscr |jms |usr | other |cics |IMS |DLa | 


Queue Manager Name [to connect to] Queue Type Queue depth 


oe weve Mame 


a FREAD IN | _ Moved | 


Remote Queue Manager Name [remote queues only] Save 0 | Purge | 
| Load ( | Display | 


Selector 


> Close Options 
Read W | Write | Browse O | Stat Browse | i ent |B Prev | End Brows SE | @ tone 


Delete 
File Code Page ‘ee 
4a7 User Props: 
: ’ * AsQueue | - Cluster Open 
Rees nate ee Sone f As Queue 


[C:student\Mapping_database\Reac\data\Employee. Cobol dat 73 ge Bind Open 


BPFH? (* Not Fixed 


Save File | Clear Data | Clear All | Load Names Set Conn d|  Compat © Group 


COBOL Copy Book File Mame Put/Get Options 


IY New Msg Id | New Correl Id 
. oe . 7 . . | GetbyMsgld = 7 Logical Order 
15.16.36 79 bytes read from file C:\student\Mapping_database\HeadsidatasEm | Getby Correlid [| Complete Msg 
. GetbyGroupld | All Avail 
[ Setiden Contest [ Corvert 
[ SetAll Contest [ Alternate User Id 


E sit | 
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__5. Click the Data tab to take a look at the data that we will send in to the application. Initially, the 
data will appear in its raw format. Click the COBOL radio button to apply the original COBOL copybook 
to this data. As a reminder, the copybook is stored in: 

c:\ student \ mapping _database \ resources \ Employee.cpy. 
Note that the data contains a value for EMPLOYEE-NO. The value shown below is 000030. 


The input file may have been changed for other scenarios, but this value should be one of 
000010, 000020, 000030. 


Note that the other data fields have just been populated with dummy data. 


anus via — a ae) 
File Edit Search | Read Write View Ids MQ Help | 
|UsrProp|RFH |PubSub|pser |jms |usr | other |cics |IMS |DLQ | 


Data Format 


© | €° Character 
Len Type Occ Variable Name Value “ Plies, 3 


7a EMPLOYEE Beth 
6 CHAR FMPLOYEE-NO 000030 a 
12 CHAR FIRST-NAME First name 
18 1 CHAR MID-INITIAL WY 
19 15 CHAR LAST-NAME Last name 
a4 CHAR WOREK—- DEPARTMENT ABC 
a7 CHAR PHONE 1234 
41 6 CHAR JOB JobCode 
49 NUMB ED-LEVEL 56 g ioe 
at CHAR SEA M L ———___—_— 
52 NUMB SALARY 111111111 Packed Dec 
61 NUMB BONUS 222222222 PE [Intel 
70 NUMB COMMISSION 333333333 (HOST (330) | 
Copy book size 79, Data area size 79 Char Format [Alt] 
fe Ascii 
C Ebedic 
€ Simp Chinese 
f Korean 
C° Trad Chinese 
C* Japanese 
C Thai 
{ Russian 


Integer Format: 


. CRALE [ Indent 
. EDI [ Validate 


Copybook, | 
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6. Click back to the Main tab, then click Write Q. 









wag MAPPING.READIN 





File Edit search : Read Write View Ids MQ Help = : | = - | ae 
[Main |/Data |MOQMD|PS | UsrProp|RFH |PubSub|pser |jms |usr | other |cics |IMS |DLQ | 


Queue Type = Queue depth 


IBSMGR +| [Local (0 


Queue Mame 


| 
| MAPPING.READ.IN = Move G | 


| 
| Remote Queue Manager Name [remote queues only] Save 0 | Purge @ | 
| 

| Load tl | Display G | 


Selector 


| ' 
> Close Options 
| Read 1) | Browse G | Start Browse | Browse Nest 


Queue Manager Name [to connect to] 
| 


Close ( | f® None 











Delete 
File Code Page eo 
Aa ~ User Prope ——\ << 
( AsQueue | — Cluster Open 
File Name | Data size Chane (* As Queue 
[73 “Yes © Bind Open 
: : (~ RFH2 ( Not Fixed 
Open File | Save File | Clear Data | Clear All | Load Names) Set Conn |  Compat © Group 








| COBOL Copy Book File Mame — Put?Get Options 


Employee. cpy IY New Meg ld [ New Corel Id 


ee . Be [ GetbyMegld [ Logical Order 
15.26.09 Message sent to MAPPING.READIN length=?9 A [ GetbyCorelid | Complete Meg 


15.20.05 copybook file read (Employee. coy] 
16.27.50 79 bytes read from file C:\student\Mapping_database\Aead‘data\e rm a GetbyGroupld [ AllAvail 
[ Setlden Contest [ Convert 


. Set All Context [ Altermate User Id 


 —— Exit | 
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7. The application will now process the message that you have just sent. 


On the Main tab, use the drop-down to set the Queue Name to MAPPING.READ.OUT and then 


click Read Q. 


Vg MAPPING.READ.OUT. 


ee 


File Edit Search Read Write View Ids MQ Help 
Main |Data | MQMD| PS 


Queue Manager Name [to connect to] 


(EERIE 





Queue Mame 


MAPPING. AEAD.OUT 


Remote Queue Manager Name [remote queues only] 


: ee 









Selector 
P| ; 
| > Close Options 
Write @ | Browse | Start Browse | Browse Next Close O | @ lone 
| : | : f Delete 
ple Code Page ee 
|43? -UserProps—— ate 
File N ste 6 @ As Queue | - Cluster Open- 
ae ca nee € None i As Queue 
|73 Yes € Bind Open 
| | (" AFH? ° Not Fixed 
Upen File | Save File | Clear Data | | Clear All | Load Names) Set Conn td | © Compat ( Group 
1 
COBOL Copy Book File Mame - Put/Get Options 
Employee. coy IY New Msg Id [New Corel Id 
oe . a _ a [ GetbyMegld [Logical Order 
15.30.32 Meg read from MAPPING.READ OUT length="9 [ GetbyCorelid | Complete Meg 
15.26.09 Message sent to MAPPING.AEADIN length="9 - 
16.26.05 copybook, tile read (Employee. cpy] z Get by Group Id a All Avail 
15.27.50 79 bytes read from file C:\student\Mapping_ database\ReadsdatasEm [ Setiden Context [~ Convert 
[ Set AllContest [ Altermate User Id 
4 | i b Exit | 
| 
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|UsrProp|RFH |PubSub| pser |jms |usr | other | CICS |IMS |DLQ | 


Queue Type Queue depth 


= Move O | 


Save @ Purge | 
_Sevea | | 
Load G | Display G | 
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__8. — After RFHUtil successfully reads a message (you may need to click ReadQ a few times, since 
the application will need to connect to the database, which may also be paged out of memory), click the 
Data tab. 


Note that the required database row from the EMPLOYEE table has been retrieved and has 
been mapped to the format required by the original COBOL copybook. 






Edit ers a Write Ids 





File 





View 


lusr | other | CICS | IMS 





|DLa | 





Data Format 
bevel Ofs Len Type Occ Variable Name Value _ * oo 
O1 8) 7G EMPLOYEE Both 
O03 a 6 CHAR EMPLOYEE-HO 000030 oO ML 
O03 6 12 CHAR FIRST-NAME SALLY rc PAFISED 
O43 18 1 CHAR MID-INITIAL re @ COBOL 
O03 19 15 CHAR LAST —-NAME KWAN c JSON 
03 a4 a CHAR WORK—- DEPARTMENT col ‘a Else 
OS al 4 CHAR PHONE 4738 iene Raines 
O3 41 & CHAR JOB MANAGER . 
| = f* PC [Intel] 
O3 46 2 NUMB ED-LEVEL 20 © HOST (390) 
O03 ol 1 CHAR SEX FE  eimetriseriicetesiasies tet 
03 52 9 NUMB SALARY 009825000 ~ Packed Dec— 
03 61 9 NUMB BONUS gooosoo00 PC [Intel] 
a3 70 9 NUMB COMMISSION go03s06000 (HOST (330) 
Copy book size 79, Data area size 79 - Char Format (4lt]— 
f Ascii 


__9. Close RFHUTIL and close the RetrieveEmployee.msgflow. 








This concludes the basic introduction to the Mapping node and database retrievals. 


__10. Proceed with Section 3.5 to clean up if you are not doing the next section. 
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3.4 Using a Stored Procedure in a map 


IBM Integration Bus Version 9 expands the capabilities of the Mapping node to support Database Stored 
Procedures. 


A Stored Procedure is simply a program that is stored on the database server. Usually written in SQL, 
the Stored Procedure benefits from the power and proximity of the database from which it is managed. 


Stored Procedures offer you many other benefits, as well. 


e They allow you to encapsulate code. In other words, the database operation appears once, in the 
stored procedure, not multiple times throughout your application source. This improves 
debugging as well as maintainability. 

e Changes to the database schema affect your source code in only one place, the stored 
procedure. Any schema changes then become a DBA task rather than a wholesale code 
revision. 

e Since the Stored Procedures reside on the server, you can set tighter security restrictions on the 
client space, saving more trusted database permissions for the well-protected Stored Procedures 
themselves. 

e Since Stored Procedures are compiled and stored outside the application, they can use more 
sensitive variables within the SQL syntax, such as passwords or personal data that you would 
avoid using in scripts or remote calls. 

e Using Stored Procedures greatly reduces network traffic. 


If you just put a series of SQL statements in your client code, each line is executed by sending a 
message over the network to the server, usually getting a response in return. But a Stored Procedure 
resides on the server. When called from the client application, it executes on the server and only has to 
respond when returning the final result set to the client, saving lots of back-and-forth traffic. 


Please note that currently, Integration Bus supports only Stored Procedures for DB2. This support will 
be expanded in the future. 


In this lab, you will investigate the new Mapping Node in IBM Integration Bus Version 9 and its support 
for DB Stored Procedures. 


You will first connect to the SAMPLE database and create a new Stored Procedure that will select 
columns from different tables. You will deploy the procedure to the database and test it. Further, you will 
import a message flow and you will use the new Stored Procedure for your database mapping. Finally, 
you will test the message flow in the Integration Bus test tool. 


You will be able to experience the benefits of using Stored Procedures to simplify a mapping application 


when data is required from different tables in a database. Also, you will experience the tools that have 
been integrated in IBM Integration Bus for creating, deploying and implementing Stored Procedures. 
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> > Dx ge 
ID PS, ul 


Input ie a“ Output 
ns - - 
~o 


() 


is 
Mepping Employee details: 
e Employee No 
e Employee First Name 
e Employee Last Name 
e Department 
e Project No 
e Project Name 









Input: 
eEmployee Number 
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3.4.1 Database definition and DB2 Stored Procedure 


Be sure you have completed the steps in Section 3.2 before starting this section. 


1. In the Integration Bus Toolkit, double-click on Data Source Explorer. 

















(ie Integration Nodes Pe] Data Source Explorer | oq 
ES Te)? | do | BY 








4 (= Database Connections 
ES BIRT Classic Models Sample Database 
Es CNTRYDB [DB2 Alias] 
Es CUSTDB (DB? Alias] 
Es NEWEMPDB [DB2 Alias] 
é re SAMPLE (DB2 for Linux, UNIX, and Windows V9.7) 


» [J SAMPLE 
4 (= ODA Data Sources 
(=> Classic Models Inc. Sample Database 
(=> Flat File Data Source 
(2 JDBC Data Source 
[> Web Services Data Source 
(=> AML Data Source 





IBM Software 


__2. — The view will be expanded and you will see the databases. Right-click on SAMPLE and then 


click Connect. 














oe Integration Nodes | Le 





4 (= Database Connections 
ES BIRT Classic Models Sample Database 
Es CNTRYDB [DB2 Alias] 


ES CUSTDB [DB2 Alias] 
\ ES NEWEMPDB [DB2 Alias] 





(= Classic ‘Disconnect 
ra dou Ping... 

(=> Web Se Work Offline 
l= AML D Save Offline 


lf Connect is greyed out, then you are already connected. Move to step 5. 


Lab 3 — Graphical Data Mapper 


Page 141 


IBM Software 


3. Toset up the connection to the database, keep the default fields and fill in the following fields: 
User name: db2admin:; 
Password: db8admin; 
Tick the box ‘Save password’ 


Click on ‘Test connection’. 


type filter text 


Common 
Default Schema Filter 
Default Stored Procedure F 


Default Table Filter Properties 


Driver Properties General 


Version Database: SAMPLE 


Host: localhost 
Port number: 50000 
| Use client authentication 


eal 


Password: 


Default schema: 


Connection URL) jdbe:db2://localhost:50000/SAMPLE:retrieveMe 
ssagesFromServerOnGetMessage=true: 





Click OK again to close the properties for SAMPLE. 
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__5. You are now connected to the SAMPLE database. Expand the SAMPLE database and then the 
Schemas folder. 








F & Database Connections 


ES BIRT Classic Models Sample Database 
Es CNTRYDB [DEB2 Alias] 
Es CUSTDB [DB2 Alias] 
Es NEWEMPDB [DB2 Alias] 
2 SAMPLE (DB? for Linux, UNIX, and Windows V9.7) | 
i |] SAMPLE 
» (2) Federated Database Objects 


» LQ Groups 
» (2) Roles 
== (9 Schemas 


> [) Users 
4 (2 ODA Data Sources 
(=> Classic Models Inc. Sample Database 
(=> Flat File Data Source 
(= JDBC Data Source 
[> Web Services Data Source 
(=> AML Data Source 





_ 6. Expand the schema ADMIN and then Stored Procedures. The database contains one sample 
Stored Procedure. This is where we will be adding our own procedure. 


r 44 SAMPLE (DB? for Linux, UNIX, and Windows V9.7) | 
4 SAMPLE 
» () Federated Database Objects 
>» LQ Groups 
> [9 Roles 


(4) Schemas 
 * a &] ADMIN 
> () Aliases 
» ( Dependencies 
> () Global Variables 
> La MQTs 
» () Packages 


» (2) Sequences 
4 () Stored Procedures 


» 20 BONUS_INCREASE 
> [) Tables 
> () User-Defined Functions 
» (2) User-Defined Types 
> (9 Views 
> [) XML Schemas 


You will now create a new Stored Procedure that we will use in our application. 
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_ 7. Start by creating a new Data Development Project. If you still have the Data Source Explorer 
expanded, double-click on its tab to return to the default view of the Integration development 
perspective. 


In Application Development, right-click in a blank area, then select New > Other. 











































































































































| Application Development New... Ls Web Services e 
eee ee ee ee et _ gee! _ 2 Message Flow 
> 8) Mapping DB Read New : ne 
> EA Mapping_Lib Subflow 
4 |) Independent Resource Copy [=/ Message Model... | 
> I= GeneratedBarFiles Paste Fe Message Map | 
Delete & ESQL File 
Move... Ft Broker Schema 
Rename... fe; Adapter Connection 
Database Definitio 
| ee U a sid inition 
a ey Data Lineage Documents 
ey 6 Export... ¥ 
L . 4 (ff BAR file 
a Integration Nodes a Daf Refresh | Integration Bus Test Client 
& Ge [el ] fel eal eT] py a = — oF Decision Service | 
(= Database Connections * || Graph | Use “ij ~=MQ Service | 
ES BIRT Classic Models Sample Database ai — 7 § Raion Gare | 
ES CNTRYDB [DB2 Alias] I che Sor | 
Es CUSTDB [DB2 Alias] "||| Property Application 
Ea NEWEMPDEB [DB2 Alias] Integration Service 
aa SAMPLE (DB2 for Linux, UNIX, and Windows V9./) =i, Library 
LJ) SAMPLE 7 ae 
|) Federated Database Objects ol baa 
C5 Groups fo ~=- Pattern Authoring Project 
LD Roles Independent Resources b 
(>) Schemas 
BG ADMIN ju. Data Analysis Project 
LD Aliases fs DICOM Input Node Configurable Service 
Lj Dependencies k) Medical Device Input Node Configurable Service | 
=) = basi ual |_* | Efe Healthcare Pattern Test | 
ee 
O Mapping_DB_Read | 
1° Mapping bi Example... 





ey “| «g a) fe] ce Cre | 
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_ 8. In the opened window, expand Data and select Data Development Project, then click Next 
(check Show All Wizards if not seen). 


Select a wizard 


Create a Data Development Project 














Wizards: 
type filter text 


L.. Existing RAD 6.x Data Definition Project 


2m] Physical Data Model 

bar SQL or XQuery Script 

SU Stored Procedure 

sol User-Defined Function 

#5) WebSphere MQ User-Defined Function 
> L= $QU Applications 


Show All Wizards. 











Finish 





_ 9. lf you see the following message, click OK. 


Rr contire Enenenee | es 


This action requires the enablement of "Database Development”. 


Enable the required activity? 





("| Always enable activities and don't ask me again 
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__10. Name the new Data Development Project StoredProceduresDDP and click Next. 


(ie) New Data Development Project 


Data Development Project 
Specify a basic definition for the new project. Use the project to store a set of Vou 


objects that can be deployed. 


Project name: [StcredProceduresDDP | ProceduresDDP | 





























__11. On the following screen, select the previously created SAMPLE connection. Click on Next. 


(i) New Data Development Project 


Select Connection 


Choose to use a new connection or select an existing connection. 














Connections 
ES BIRT Classic Models Sample Database 
ES CNTRYDB 
Ea CUSTDB 


* Properties 
Property Value 
Name SAMPLE 
Description 
Category Database Connections 
Database SAMPLE 
JDBC Driver Class comJbm.db2.jcc.DB2Driver 
Class Location CAIBM\SDPShared\ plugins\com.ibm.datat... 
Connection URL jdbe:db2://localhost:50000/SAMPLE:retriev... 
UserID db2zadmin 
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__12. Enter ADMIN as the Default Schema, and then click on Finish to create the Project. 


| (i) New Data Development Project 


Default Application Process Settings 


Specify the default values for the database manager to use for SQL staternents. 


Default schema: § 5!) 


Omit default schema in generated statements 


Default path: | SYSIBM,SYSFUN,SYSPROC SYSIBMADM,DB2ZADMIN 





13. 


. This kind of project is associated with the Data perspective. Do you want to open this 
perspective now? 


[| Remember my decision 
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__14. The Data Project Explorer view will be added to the Application Development perspective 


(bottom left — next to Data Source Explorer). 





ta Integration Nodes hes Data Source Explorer = Dai 


4 (&: SAMPLE 
a La Data Models 
4 28) SAMPLE.dbm 
» {J SAMPLE 
. (5 Other Files 
- (& SOL Scripts 


- ) Data Diagrams 
. 1) StoredProceduresDDP (SAMPLE:jdbe:db2://localhost:50000/SAMPLE:retrieveMessaqi 


| Ti I 


lf you do not see the view, go to Window > Show View and click on Data Project Explorer. 


__15. If the SAMPLE.dbm file is opened, close the SAMPLE.dbm file. 


2 SAMPLE.dbm| >< } 


__16. Double-click on Data Source Explorer to view in full screen. 


* Data Source Explorer 


__17. You should still be connected to the SAMPLE database. If you have been disconnected, right- 
click on SAMPLE and then Connect. Since you created a database connection earlier, you do not have 


to go through the set up step. 
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18. Expand SAMPLE > Schemas > ADMIN. To open the editor for creating a new procedure, 


right-click on Stored Procedures then New>With Routine Editor.... 






Go Integration Nodes tS. Data Project Explorer 


, (=> Database Connections _ 
ES BIRT Classic Models Sarnple Database 

Es CNTRYDB [DB2 Alias] 

E39 CUSTDB [DB2 Alias] 


: Ea NEWEMPDB [DB? Alias] 
aa SAMPLE (DB2 for Linux, UNIA, and Windows V9.7) 
a {Jj SAMPLE 


» (5) Federated Database Objects 

> (2 Groups 

> [) Roles 

4a {) Schemas 
ma BE ADMIN 

> (2 Aliases 
» (9 Dependencies 
» (-) Global Variables 
> (9 MOTs 
» () Packages 
» (5) Sequences 


4 stored Procedure! 


' 20 BONUS INCF New | sO With Routine Editor... 
> [9 Tables PoP | sal = With SQL Editor 
> () User-Defined Fur 
» () User-Defined Tyy “ETE 2 
» (5 Views => Filter... 
> (2) XML Schemas 
. BE ain 






We, 





Properties Alt+ Enter 


__19. Inthe newly opened window, you should edit the following fields: 
Project — StoredProceduresDDP (select from drop-down if not automatically filled in) 
Name — EMPLOYEEDETAILS 


Language — SQL (select from drop-down) 
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Once finished you should have a similar view as below: 


©) New Stored Proced 


| Name and bangueds 


Create a new SQL stored procedure with the editor in a new or existing data development project. 


StoredProceduresDDP Peet { Newn 
Name: EMPLOYEEDETAILS | 
Language: {SOL | Oe 


Java package: /com. admin.admin 














Java options 
@ Dynamic SQL using JDBC 
Static SQL using SQU 
Root package: | S448501 











SQLJ translator location: C:\IBM\SQLLIB\java\sqlj.zip 











SQLJ translator class name: | sqlj.tools.Sqlj 











_ 20. Click Finish. 


_ 21. Integration Bus Toolkit creates the procedure and opens the editor with a few lines already 
written. You will also notice that the Toolkit has created a new file in the Application Development view — 
EMPLOYEEDETAILS.spxnii. 








CREATE PROCEDURE EMPLOYEEDETAILS ( 


a DYNAMIC RESULT SETS 1 
Application Development 


> [Al Mapping_DB_Read 
> BA Mapping_Lib 
4 (| Independent Resources 


a GeneratedBarfiles ee 


DECLARE cursori CURSOR WITH RETURN FOR 
SELECT PROCSCHEMA, PROCNAME FROM SYSCAT.PROCEDURES; 


-- Cursor left open for client application 
OPEN cursori; 
END Pi 











(a Integrati [BB Data Sour 85. Data Proj 3 N\ 


(2: SAMPLE 
(5 Data Diagrams 
C@ Data Models 
=m] SAMPLE.dbm 





























() Other Files 
> SOL Scripts 

‘Uy StoredProceduresDDP (SAMPLE:jMbc:db2://localhost 7 : 

(5 SQL Scripts Configuration | Source 

( Stored Procedures - —S! a — 

Sg EMPLOYEEDETAILS | Properties £2 \ [21 Problems| 5= Outline) 4) Tasks) FE] Deployment Log) re 

~~ |) User-Defined Functions aaaiie Mater 

& XML Artifact 

last modified July 25, 2013 at 4:53:35 PM 
ld : name StoredProceduresDDP 
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22. The procedure that we will use in this lab has been written for you. 


Using Windows Explorer, navigate to 
C:\student\Mapping_database\StoredProcedures\Procedure and open the text file 
Workshop_Stored_Procedure.txt 


e) Workshop_Stored_Procedure.bct - Notepad > : - (Oj x| 
File Edit Format View Help 
CREATE PROCEDURE EMPLOYEEDETAILS ( IN EmpLikeNoIn VARCHAR(50), OUT DescriptionOut VARCHAR(100) ) = 


LANGUAGE SQL 
DYNAMIC RESULT SETS 4 


P1: BEGIN 


DECLARE WorkDep CHAR(50); 
DECLARE EmpNum CHAR(50); 
DECLARE ProjNum CHAR(50); 
DECLARE depno CHAR(50); 
DECLARE e_no CHAR(50); 
DECLARE f_name CHAR(50); 
DECLARE 1_name CHAR(50); 
DECLARE p_num CHAR(50); 


-- Declare cursors -- 
-- ‘cursor1" will return a result set of employee number, first name, last name 
-- and the work department code from the EMPLOYEE table 


DECLARE cursorl CURSOR WITH RETURN FOR . 
SELECT EMPNO, FIRSTNME, LASTNAME, WORKDEPT FROM EMPLOYEE WHERE EMPNO IN( EmpLikeNoIn ); 


--'cursor2" returns department number and department name from table DEPARTMENT 
-- the select statement uses the deparment code returned from cursorl 


DECLARE cursor2 CURSOR WITH RETURN FOR 
SELECT DEPTNO, DEPTNAME FROM DEPARTMENT WHERE DEPTNO INC WorkDep ); 


--'cursor3" returns project number from table EMPPROJACT 
-- the select statement uses the employee number returned from cursori 


DECLARE cursor3 CURSOR WITH RETURN FOR 
SELECT PROJNO FROM EMPPROJACT WHERE EMPNO INC EmpNum ); 


--'cursor4" returns the project name from table PROJECT 
-- the select statement uses the project number returned from cursor3 


DECLARE cursor4 CURSOR WITH RETURN FOR 
SELECT PROJNAME FROM PROJECT WHERE PROJNO INC ProjNnum ); 


-- assign values to variables 


OPEN cursor1; 

FETCH cursorl INTO e_no, f_name, |l_name, depno; 
SET workDep = depno; 

SET EmpNum = e_no; 

CLOSE cursor; 


OPEN cursor3; 

FETCH cursor3 INTO p_num; 
SET ProjNum = p_num; 
CLOSE cursor3; 


-- cursors left open for client application 
OPEN cursor1; 


OPEN cursor2; 
OPEN cursor3; 
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__ 23. Copy the entire text (CTRL-A / CTRL — C) and paste it (CTRL-V) back in the Integration Bus 
Toolkit editor (delete the previously generated default code). Double-click on the tab with the Procedure 
name to expand the window. 


=) *EMPLOYEEDETAILS [E: im 


REATE PROCEDURE EMPLOYEEDETAILS ( IN EmpLikeNoIn VARCHAR(50), OUT DescriptionOut VARCHAR(100) ) “ 
LANGUAGE 5QL 
DYNAMIC RESULT SETS 4 





Pi: BEGIN 


WI 


DECLARE WorkDep CHAR(5S0); 
DECLARE EmpNum CHAR(50); 
DECLARE ProjNum CHAR(50); 
DECLARE depno CHAR(50); 
DECLARE e no CHAR(50); 
DECLARE f name CHAR(50); 
DECLARE 1 name CHAR(50); 
DECLARE p num CHAR(50); 


-- Declare cursors -- 
-- ‘cursori' will return a result set of employee number, first name, last name 
-- and the work department code from the EMPLOYEE table 


DECLARE cursori CURSOR WITH RETURN FOR 
SELECT EMPNO, FIRSTINME, LASTNAME, WORKDEPT FROM EMPLOYEE WHERE EMPNO IN( EmpLikeNolIn ); 


--'cursor2' returns department number and department name from table DEPARTMENT 


-- the select statement uses the deparment code returned from cursori 


DECLARE cursor2 CURSOR WITH RETURN FOR 
SELECT DEPTNO, DEPTNAME FROM DEPARTMENT WHERE DEPTNO IN( WorkDep ); 


--'cursor3' returns project number from table EMPPROJACT 


-- the select statement uses the emplovee number returned from cursori 


__24. Close the Notepad window. 

__25. The Stored Procedure is written in SQL. It starts by defining the input and output parameters. 
Then it defines the number of “result sets” which are the values returned from the “Select” statements 
that follow in the procedure. 


The cursors are dynamic variables that store the return results before being sent to the 
requesting application. 


Please take a moment to go through the procedure and the comments for each operation. 
In summary, the procedure takes an input value for “Employee Number” and returns data for the 
selected employee from four different tables in the SAMPLE database. Within the procedure 


selected values from one table are used for selecting rows from other tables. 


This shows how you can make one call to the database and have a number of operations 
completed on the database server before the result is returned back. 


The first “select” statement returns three columns from the EMPLOYEE table. 


When finished reviewing, double-click on the tab EMPLOYEEDETAILS to return to Integration 
Development perspective. 


Make sure you save the new procedure with Ctrl+S. sah ee 
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26. Close the EMPLOYEEDETAILS Stored Procedure. 





__ 27. Inthe Data Project Explorer, right-click on the newly created procedure 
EMPLOYEEDETAILS and then Deploy.... 





Avolicati si im] 0 ANGUAGE ! 
pplication Development pen neat 
Mapping DB_Read % Delete aa 
Mapping_Lib oe + SQL Ste 
Independent Resources | 

“ Co 
[= GeneratedBarFiles oPy BEGIN 

— StoredProceduresDDP) 4 ae 

* joomonnca| pect 
me wea se DECLAI 
Run Profiling... DECLAI 
Sinn Settee DECLAI 
tun Settings... aeons 
_ DECLAI 
Debug... DECLAI 
DECLAI 


ie Integration (te Data Source | Validate 


Team » | De 


4 & SAMPLE Compare With - — 
» (2 Data Diagrams : -- ant 
Replace With b 
a (gq Data Models aia 
coh oc DECLAI 
fa] SAMPLE.dbm Start Simulation 
b [) Other Files 
> CS SQL Scripts 


Stop Simulation 


4 {LJ StoredProceduresDDP (S¢ Edit and Arrange Palette ... — aa 
(3 SOL Scripts Run in New Workbench... ar 
uration | Sou 
() Stored Procedures Package... == 
» | EMPLOYEEDETAIL "r=rrroperties £3 
( User-Defined Functions | 
> a XML #0 EMPLOYEEL 
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__ 28. You are deploying the procedure to the SAMPLE database and a “Deploy Options” window will 
open. Ensure ADMIN is selected as the Target schema, and then click Next. 


‘| Deploy Options 
Specify options for the deployment. 


Target database 
(@) Use current database 
() Use different database 


Database: Connection... 


Target schema and default path for deploying an unqualified routine 


Target schema: JADMIN| 

Default path: >SYSIBM,SYSFUN,SYSPROC,SYSIBMADM,DB2ADMIN 
Duplicate handling 

(@) Drop duplicates 

() Treat duplicates as errors 


Ignore duplicates and continue to the next routine 


(@) Deploy by building the source 
() Deploy using binaries if available in the database 
("| Deploy source to the database 


Finish 
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__ 29. Click Next again. 


Routine Options 


Specify routine options. 


i= SQL Stored Procedures Precompile options: 
sé) EMPLOYEEDETAILS (IN EMPLIKENOIN 


("| Enable debugging 
Apply Folder Settings 
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__30. Finally, click Finish on the Summary window. 


The settings that you specified are surmmarized here. 











Setting Value 

Target database SAMPLE 

Target schema: ADMIN 

Routines to deploy EMPLOYEEDETAILS 

Error handling Stop and roll back on errors 
Duplicate handling Drop duplicates 

Deploy Deploy by building the source 





__31. Inthe bottom right of the perspective, a “SQL Results” tab will open showing a successful 
deployment of the procedure. 















4 Integration | 8 Data Source | &5. Data Project x i 5) © Properties | [2 Problems | G= Outline | #) Tasks | FE Deployment Log |] SQL Results £3 x %| A Eas im) 
5 &  B Type query expression here Status 
& SAMPLE ; Status Operation Date Connection Profile Deploy ADMIN.EMPLOYEEDETAILS(VARCHAR(50), VARCHAR(100)) 
Gp Teta nage: ¥ Succee Deploy AD... Jul 28, 2013... SAMPLE es 
G9 Data Models ADMIN.EMPLOYEEDETAILS - Deploy started. 
() Other Files 


DROP SPECIFIC PROCEDURE ADMIN.SQL130728210321300 
(® SQL Scripts 


ADMIN.EMPLOYEEDETAILS - Drop stored procedure completed. 
(J StoredProceduresDDP (SAMPLE:jdbe:db2://localhost:50000/ ADMIN.EMPLOYEEDETAILS - Create stored procedure completed. 


(5 SQL Scripts ADMIN.EMPLOYEEDETAILS - Deploy successful. 
(9 Stored Procedures 


$4 EMPLOYEEDETAILS 
(5 User-Defined Functions 
(3 XML 


4 | m 











3.4.2 Stored Procedures application 


You will now import a simple application and will complete all the necessary mappings. 
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b> Mapping_DB_Read 
> EA Mapping Lib 
F Independent Resources 
( [= GeneratedBarFiles 
4 [= StoredProceduresDDP 


Mew 


Copy 
Paste 
Delete 
Move... 


Rename... 


Import a project and its dependent projects from a Zip file. 


Select an import source: 


type filter text 


> ~& Modeling 

> b= Plug-in Development 
> Ge Profiling 

> ~& Run/Debug 

> GS Team 

> te Test 

> fe Web 

> [= Web services 


| P WebSphere ESB Project Interchange 
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le In the Application Development view, right-click in an empty area and select Import... 
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__3. Onthe next screen, click Browse... for From zip file. 


(i) Import Project Interchange Contents 


Import Projects 
Import Projects from a zip file. 
































From zip file: 


Project location root) =C:\student\Mapping_database\ workspace 


Select All| | Deselect All| | Select Referenced 
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_ A, Navigate to C:\student\Mapping_database\Stored_Procedures\Install and select 
Stored Procedures _Start.zip. Click Open. 


(i Open uit 


OO « Stored_Procedures + Install > + | +4 | 


Organize ¥ New folder 





























ww Favorites = Name Date modified 


MM) Desktop 7) Stored Procedures Start 7/18/2013 9:06 AM 
a Downloads 


| Recent Places 


Compressed (zipp... 


Libraries 
[=| Documents 
al’ Music 
=| Pictures 
ee Videos 


ile! Computer 
&, Local Disk (C:) 
(2 Shared Folders (\ + | 4 | 


Filename: Stored_Procedures_Start 
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__5S. Ensure both folders are selected. Click Finish to complete the import: 


—————————— 
(i) Import Project Interchange Contents 
—— Ee 


Import Projects 
Import Projects from a zip file. 


From zip file: C\student\Mapping_database\Stored_Procedures\Ins * | Br 


Project location root: $C:\student\Mapping_database\workspace 


l= StoredProcedures Lib 
l= Stored Procedures 


Select All| | Deselect All| | Select Referenced 





_ 6. Review the imported application. You will see the application message flow and its library which 
includes the schema file that is being used. 


Application Development 


b> Mapping_DB_Read 
r Stored Procedures 
4 | Flows 
StoredProcedures_Flow.msgflow 
4 | References 
4 BA StoredProcedures Lib 
4 (=. Schema Definitions 
a £& http://www.example.org/Employee 
[Ss] Employee _SP.xsd 


r) Fil Other Resources 
> Teqe SAMPLE 
» (5 Other Resources 


> BBA StoredProcedures_Lib 
F Independent Resources 
» LS GeneratedBarFiles 
> LS StoredProceduresDDP 
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__/. You will now create a new database definition that the application will use. Right-click on the 
imported application and select New Database definition. 














= 
= + 


=) Application Developme : 




















plication Developme 








> Fae Mapping_DB_Read 
a | fa) Stored_Procedures| 
F ae Flows 
Ral StoredProce 
4 \fR) References 
4 BA StoredProce 
4 (= Schema 
a = http: 


ee 


Mew 


Manage Library references 
Manage included projects 


Focus on Application 


Convert to Library 

Export A5Ds from Application 
Migrate 

Go Into 


Copy 


Paste 


EIS 


Ci 
i 
Ce 


Message Flow 
Subflow 

Message Model... 
Message Map 
ESQL File 


Broker Schema 


Adapter Connection 





Data Lineage Documents 
BAR file 
Integration Bus Test Client 


Decision Service 


_ 8. Use the drop-down list to select the SAMPLE Data design project created earlier. Make sure 
DB2 and V9.7 are selected. Click Next. 


r 


Create a database definition file 








Specity the database type, version and the data design project that will contain the database definition file. 
































Data design project: Sé 
Database: 


Version: 
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__9. | Onthe next screen select SAMPLE (we created it earlier to connect to the database) and then 
Next. 


Select Connection 


Select an existing connection. 








Connections 


* Properties 
Property Value 
Name SAMPLE 
Description 
Category Database Connections 
Database SAMPLE 
JDBC Driver Class comJbm.db2.jcc.DB2Driver 
Class Location CAIBM\SDPShared\ plugins\com.ibm.datat... 
Connection URL jdbe:db2://localhost:50000/SAMPLE:retriev... 
UserID db2admin 




















__10. Select Yes to confirm the updating of the existing file. 


Confirm file overwrite 


ia y The existing database definition file "SAMPLE.dbm" in the data design 
P project connects to the same database. 
Click "Yes" to confirm overwriting the file, or click "No" and choose a 


connection to a different database. 
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11. Select the ADMIN schema and click Next. 


Select Schema 


Select schema(s) to reverse engineer. 


Apply name filter (? = Any character, * = Any string): 


Select objects: 
NULUD 

H squ 

[=] SYSCAT 

[| SYSFUN 

[| S¥YSIBM 

[| SYSIBMADM 
[| SYSIBMINTERNAL 
[| SYSIBMTS 
| SYSPROC 
[| SYSPUBLIC 
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__12. For Database Elements, make sure that you check Routines and then click Finish. 


(D) New Database Definition Fle aaa 
Database Elements 


Select database elerments for the model. 


Database elements 
Tables 

Indexes 
Triggers 


Routines 

(| User-defined types 

Sequences 

Table spaces 

[| Privileges, Roles, Users, and Groups 


ry (one) 


—_—_—EEEE rrr 





__13. Close the file SAMPLE.dbm file. 


al SAMPLE.dbm[ >< Js 


Important: Please note that if you create/edit/ update a Stored Procedure you will have to go 
through steps 7 — 13 again, in order to be able to work with the most current procedures. There 
is no “Refresh” capability. 

__14. Double-click on StoredProcedures_Flow.msgflow to open the application message flow. 


Application Developme = 25 Ee, Patterns Explorer] ~ O1 | StoredProcedures_Flow.msgflow 23 













@ es || 4 & Palette 
Application Development New... [fe ‘ a a 
= Favorit 
Mapping_DB_Read * Ee = = 
Stored_Procedures ing WebSphere MQ 
> Flows ums JIMS = | 
él StoredProcedures_Flow.msgflow (za, HTTP | MQ Input MQ Output 
a hiviestasassi Lo Web Services 
Be, StoredProcedures_Lib — | | 
eS. Schema Definitions Pahl 
Ee http://www.example.org/Employee =|| ‘aj: WebSphere Adapters 
[5] Employee_SP.xsd UL} Routing 
(= Other Resources (a NET 
ag, SAMPLE 
ee 3g) SAMPLE.dbm Transformation 
(= Other Resources Lal Construction 
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__15. Once the flow is opened, single click on the MQ Input node. Click on the Basic tab in 
Properties to see its queue. You may have to click the Properties tab if it is not already selected. 


fe3 StoredProcedures_Flow.msgqflow 2 el) 
q ae Palette 
S\o a 
—————— 
GBWebSenicessssss 
(o SCA 
(G@ WebSphere Adapters 
ee 
fj Database 
= File 


a 


- 





Graph | User Defined Properties 








© | Properties ff Ete Problems| = Outhine| £) Tasks | FB Deployment Log| 2 SQL Reaults| ae’ "68 


I= MQ Input Node Properties - MQ Input 
eee 
Input Message Parsing Queue name* 





Browse MQ Services 





Parser Options 


Validation 


__16. Click on the Input Message Parsing tab and for Message domain select XMLNSC. 


__. Properties x 5 Fa Problems| = Outline | £ Tasks | EE Deployment Log ES sqQi Reais al ~~ |- 












/XMLNSC : For XML messages (namespace aware, validation, lov + 


Message model | 


Message 





Security Physical format 
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__17. Drag and drop a Mapping node, from the Transformation folder, into the message flow between 


the two MQ nodes. 


=] *StoredProcedures Flow. 


4 2 Palette 
ams JMS 
La» Web Services 
(ol, SCA 
(gi: WebSphere Adapters J 
C3 Routing | 
(rat NET 
(2! Transformation <9 
e METCompute . 
<=} Mapping 
Sy) XSLTransform 
ge Compute 
@2 JavaCompute 
aa PHPCompute 


La Construction ‘e 


__18. Double-click on the Mapping node. 


jai’ 


MQ Input 
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‘al 


MQ Output 
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__19. Keep the default values for the message map and click Next. 


Specify a new message map file 


Select map type, container, name, and broker schema for the new map. 


Type of map that you want to create: 
(@) Message map called by a message flow node 
Submap called by another map 


Container: | Stored_Procedures sae N 


Map name StoredProcedures_Flow_Mapping 
Map organization 
Use default broker schema 


Schema: | (default broker schema) 
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__20. Expand StoredProcedures_lib for map inputs and map outputs. Select the Employee schema 
as the map input, and select the EmployeeData schema as the map output. Click Next. 





select map inputs and outputs 


Creates a map that can contain message inputs and outputs with the Properties folder. Optionally, database operations, message 
headers, and LocalEnvironment can be added to the map after creation. 














Filter map input names (? = any character, * = any String): Filter map output names (? = any character, * = any String): 


Select map inputs Select map outputs 
Stored Procedures 
ms StoredProcedures_Lib @ B4StoredProcedures_ Lib 
> DFEDL and XML Schemas a (2 DFOL and XML Schemas 
[eb Employee fhttp://www.example.org/Employee} ms ovee (httoy//www.ex org’ | 
> EmployeeData {http://www example.org/Employee} | EmployeeData {http://www.example.org/' 
(2 IBM supplied message models > (2 IBM supplied message models 


Physical Location: 


Library: =i, StoredProcedures_Lib 
Path: (= Employee _SP.xsd 
Namespace: £ {http://www.example.org/Employee} 
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__21. Onthe next screen click Finish, ensuring that XMLNSC is selected as the output domain. 


select the domain to create the output 


Set the output domain of main map called by a message flow node 











\ 





__ 22. Inthe opened map, connect Employee with EmployeeData by hovering over Employee. When 
you see the connector, grab and drop it over EmployeeData. 





Fes StoredProcedures_Flow_Mapping 





~StoredProcedures Flow_Mapping ~~ as ae | I> {i | , | | Ff Be ta 2A a | 





=| PoS Message Assembly Employee | El Pas Message Assembly EmployeeData 
Fe *Click to filter...> = <Click to filter... 
| | EI 5 = —, he . 
fl gf! Properties [0.1] PropertiesType | __"e|Move ~ | ‘ i gpl Properties [0.1] PropertiesType 








| & ge] Employee [1.1] Employee _—<$—$—$ $< _———————— fl gf] EmployeeData [1.1] DBOutput 
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__23. The mapper creates a Local map for the operation since you are mapping an entire structure. 
Click on Local map. 





[= StoredProcedures_Flow_Mapping 








*StoredProcedures Flow_Mapping P| ww) £|/ es | fo fe #0 | 
5 Pas Message Assembly Employee =] [gs Message Assembly EmployeeData 
=> <Click to filter...> => «Click to filter...> 
i pel Properties [0.1] PropertiesType EM | @ gpl Properties [0.1] PropertiesType 





“@ielimployee [1.2] Employee ; a sce 


__ 24. In the local map, click on the Call routine icon. If not sure, hover over the icons and you should 
see Call a database routine. 





l=} StoredProcedures Flow Mapping * gf! EmployeeData 


yStoredProcedures_Flow_Mapping _ . - ge | |b {io ] « | rt = | on Pay | 
fu 
Ee me | Employee Employee ey raf! EmployeeData DBOutput 

=> <Click to filter...> => «Click to filter...> 

EMPL_NUM [1.1] string ProcedureQutput [1.1] string 

EmployeeNo [1.1] string 

FirstName [1.1] string 

LastName [1.1] string 

[e¢] Department [1.1] string 

ProjectNo [1.1] string 

[e] ProjectName [1.1] string 
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__25. Inthe opened editor, expand Stored Procedure, click on EMPLOYEEDETAILS(2) and observe 


the following: 


e The 4 result sets (cursors) that we defined in our procedure have been populated in the 


Result sets list. 


e For each Result set, you will have to select the table columns that will be defined in the 


set. 


e You can order Result sets at your preference. 


Select a routine in a database schema 


The following list contains all databases available to the map. Select a 
stored procedure or a user-defined function. 


d Procedure 


Visitas 


Routine 





("| Return a value 

Display Routine parameter details... 
Classify SQL warning 
If checked, the first SQL operation resulting in a database warning will 
be treated as an error, and an exception will be thrown leading to the 


"Failure" transform, if present, being invoked to process the 
exception. 


(| Treat warning as error 


Define the Result sets for the selected Routine 


The Results sets returned by the Routine must be listed in the positional order they will be returned. 


You can set a description on each Result set. To enable mapping of a column from a Result set it must 
be defined. For more information... 


Result sets list (max 4 returned) 


Order returned Description Columns defined 
ResultSetl <description> 0 
ResultSet2 <description> 0 
ResultSet3 <description> 0 


Available table columns Columns defined for selected Result set 
4 ©) 88 ADMIN 

> [ES CL_SCHED 
> {—] EA DEPARTMENT 
> [| ES EMPLOYEE 
> [| ES EMP_PHOTO 
> {] FB EMP_RESUME 
> [| ES PROJECT 
> [| ES PROJACT 
> {—] ES EMPPROJACT 
> [ES ACT 
> [| EB IN_TRAY 
> [@] ES ORG 














® 
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__ 26. Wewwill start with the ResultSet1, and based on our procedure, you will define the following: 


e Click on the row with ResultSet1. Expand the EMPLOYEE table and select the columns 
EMPNO, FIRSTNME, LASTNAME and WORKDEPT. 


e Click on <description> and enter Select from EMPLOYEE. 


Select a routine in a database schema Define the Result sets for the selected Routine 


The following list contains all databases available to the map. Select a stored The Results sets returned by the Routine must be listed in the positional order they will be returned. You can 
procedure or a user-defined function. set a description on each Result set. To enable mapping of a column from a Result set it must be defined. For 


more information... 
Database | SAMPLE y| Add database... 





Result sets list (max 4 returned) 








Schema [ADMIN " 


Order returned Description Columns defined Add 
#0 Stored Procedure ] ResultSet1 _ Select from EMPLOYEE 4 


#0 BONUS_INCREASE (6) ResultSet2 ~ <description> "0 
#0 EMPLOYEEDETAILS (2) ResultSet3 <description> 0 [ a | [2 














Available table columns Columns defined for selected Result set 


EMPNO (ADMIN/EMPLOYEE) 
FIRSTNME (ADMIN/EMPLOYEE) 
LASTNAME (ADMIN/EMPLOYEE) 
WORKDEPT (ADMIN/EMPLOYEE) 














| Return a value ly) FE LASTNAME | 


Display Routine parameter details... =” WORKDEP 


Classify SQL warning 5 HIREDATE 
If checked, the first SQL operation resulting in a database warning will be 5 JOB 

treated as an error, and an exception will be thrown leading to the "Failure" Th § EDLEVEL 
transform, if present, being invoked to process the exception. B SEX 

(| § BIRTHDATE 



































Treat warning as error 
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e Click on the row with ResultSet2. Expand the DEPARTMENT table and select the 
columns DEPTNO and DEPTNAME. 


e Click on <description> and enter Select from DEPARTMENT. 


Select a routine in a database schema 


The following list contains all databases available to the map. Select a stored 
procedure or a user-defined function. 


Schema | ADMIN v 


80 Stored Procedure 
#0 BONUS_INCREASE (6) 
#0 EMPLOYEEDETAILS (2) 





Routine 








|| Return a value 
Display Routine parameter details... 
Classify SQL warning 
If checked, the first SQL operation resulting in a database warning will be 


treated as an error, and an exception will be thrown leading to the "Failure" 
transform, if present, being invoked to process the exception. 











Treat warning as error 
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Define the Result sets for the selected Routine 


The Results sets returned by the Routine must be listed in the positional order they will be returned. You can 
set a description on each Result set. To enable mapping of a column from a Result set it must be defined. For 
more information... 


Result sets list (max 4 returned) 





Order returned Description Columns defined Add 


ecu 


ResultSet2 Sel a 
ResultSet3 <description> [ a | [2 


Available table columns Columns defined for selected Result set 


4 (@) 22 ADMIN | DEPTNO (ADMIN/DEPARTMENT) 
> [&] ES CLSCHED DEPTNAME (ADMIN/DEPARTMENT) 
—_> 4 = 




















| £ MGRNO 
™] & ADMRDEPT 
™ § LOCATION 
™ FS EMPLOYEE 

F=] EMP_PHOTO 
FS EMP_RESUME 
P=] PROJECT 
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__ 28. For ResultSet3 define the following: 


e Click on the row with ResultSet3. Expand the EMPPROJACT table and select the 
column PROJNO. 


e Click on <description> and enter Select from EMPPROJACT. 


©) Select a Database Routin es 


Select a routine in a database schema Define the Result sets for the selected Routine 
The following list contains all databases available to the map. Select a stored The Results sets returned by the Routine must be listed in the positional order they will be returned. You can 











procedure or a user-defined function. set a description on each Result set. To enable mapping of a column from a Result set it must be defined. For 
Database | SAMPLE | Add database... ; 
Result sets list (max 4 returned) 
Schema | ADMIN nd Order returned Description Columns defined 
20 Stored Procedure ResultSetl Select from EMPLOYEE 4 
80 BONUS_INCREASE (6) ResultSet2 Select from DEPARTMENT 2 
' 29 EMPLOYEEDETAILS (2) ResultSet3 ‘Select from EMPPROJACT 91 [a] 














Routi 
ia Available table columns Columns defined for selected Result set 
' (| ES EMPLOYEE | PROJNO (ADMIN/EMPPROJACT) 

> [| ES EMP_PHOTO 
» |] FS EMP_RESUME 
— > [©] EA PROJECT 

| Return a value > [ES PROJACT 
Display Routine parameter details... —— i | EMPPROJACT 
= EMPNO 


Classify SQL warning 1¥_E PROJNO 
If checked, the first SQL operation resulting in a database warning will be rT e ACTNO” 





























treated as an error, and an exception will be thrown leading to the "Failure" 
P Oak “ —§ EMPTIME 
transform, if present, being invoked to process the exception. i 
| § EMSTDATE 





| (-) Treat warning as error 




















§ EMENDATE ‘ 
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e Click on the row with ResultSet4. Expand the PROJECT table and select the column 


PROJNAME. 


e Click on <description> and enter Select from PROJECT. 


'() Select a Database Routin 


Select a routine in a database schema 


The following list contains all databases available to the map. Select a stored 
procedure or a user-defined function. 


Database | SAMPLE vy | Add database... 
Schema | ADMIN Y 


20 Stored Procedure 
$9 BONUS_INCREASE (6) 
20 EMPLOYEEDETAILS (2) 





Define the Result sets for the selected Routine 


The Results sets returned by the Routine must be listed in the positional order they will be returned. You can 
set a description on each Result set. To enable mapping of a column from a Result set it must be defined. For 
more information... 


Result sets list (max 4 returned) 





ResultSet2 
ResultSet3 
ResultSet4 


Select from DEPARTMENT 
Select from EMPPROJACT 


Order returned Description Columns defined 


Ad cl 








‘Selectfrom PROJECT } | [a] [2] 


Available table columns Columns defined for selected Result set 
> (ES EMPLOYEE | | PROJNAME (ADMIN/PROJECT) 
> [) ES EMP_PHOTO 
> [-] ES) EMP_RESUME 

4 (@ & PROJECT 
] Return a value —> PROJNO 
Display Routine parameter details... = PROJNAME 
E DEPTNO , 
Classify SQL warning "| § RESPEMP 
If checked, the first SQL operation resulting in a database warning will be PRSTAFF 


treated as an error, and an exception will be thrown leading to the "Failure" 
p eae “ PRSTDATE 
transform, if present, being invoked to process the exception. PRENDATE 


MAJPROJ 


Routine 
































("| Treat warning as error 

















__ 30. Click OK. 
__ 31. This will return the map with Database Routine and Return sub maps. 


Fo StoredProcedures_Flow_Mapping * fel EmployeeData 
*StoredProcedures_Flow_Mapping ra DI I | ils {re | . 4 | = & | FE] #a Se &5 4 | 


‘a 


I ofl EmployeeData 


=> <Click to filter...> 





= ee] Employee 
=> < Click to filter...> 


[e] EMPL_NUM [1.1] string 





[€] ProcedureOQutput [1.1] string 
[é] EmployeeNo [1..1] string 
(e] FirstName [1.1] string 
[é] Department [1.1] string 
[e] Projecto [1.1] string 
ProjectNiame [1.1] string 
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__ 32. Connect EMPL_NUM to Database Routine and Return to EmployeeData. 


l=} StoredProcedures Flow_Mapping * sf) EmployeeData 





~*StoredProcedures Flow_Mapping _- ler |e a & | Bi és Te 2h 
a 
I Pe] Employee Employee al) raf! EmployeeData DBOutput 
= <Click to filter...> + <Click to filter... 





[el "=| Database Routine + ~ 7 
EMPL_NUM [1.1] string : 
. Vu Return + ms 


__ 33. Click on the Database Routine link. 





l=} StoredProcedures Flow_Mapping * sf) EmployeeData 


+StoredProcedures_Flow_Mapping . Ic - & fs to @8 
af 
© BF] Employee Employee “a gpl EmployeeData DBOutput 
FP <Click to filter...> Hs <Click to filter.... 


=| Database Routine + “ 


EMPL_NUM [1.1] string : an 
Return + ml 


__ 34. Inthe Database Routine map, connect EMPL_NUM to EMPLIKENOIN (the input parameter for 
the routine). Click on the yellow arrow to go one level up in the map. 





l= StoredProcedures Flow Mapping * sf) EmployeeData * * Call EMPLOYEEDETAILS 





*StoredProcedures_Flow_Mapping é jel Ie) 3M) we an 35] aa faz: 
EE: 
2] EMPL_NUM = os Call EMPLOYEEDETAILS 
> <Click to filter...> 


a EMPLIKENOIN [1.1] VARCHAR 
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l=} StoredProcedures Flow_Mapping * sf) EmployeeData 


~StoredProcedures. Flow Mapping 6! 49| 9: j>| | # &| Ri ie & Gp ee 


| al Employee f raf! EmployeeData 
= <Click to filter...> = <Click to filter... 


[e] EMPL_NUM [1.1] string 
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__ 36. Expand the four result sets. You will see that they have the columns that you selected in steps 
26 — 29. Make the following mappings: 


e DESCRIPTIONOUT > ProcedureOutput 
e EMPNO > EmployeeNo 

e FIRSTNME > FirstName 

e LASTNAME > LastName 

e DEPTNAME > Department 

e PROJNO >ProjectNo 

e PROJNAME >ProjectName 


Once finished your map should look like the screen capture below: 





[= StoredProcedures_Flow_Mapping * df EmployeeData * gf) EmployeeData 


*StoredProcedures_Flow_Mapping Pl [> ee Bt B= 
Sl 
= a) Return from EMPLOYEEDETAILS = raf EmployeeData DBOQutput 
=> <Click to filter..> > <Click to filter..> 
Eg? DESCRIPTIONOUT [1.1] VARCHAR “| Move ~ \  [&] ProcedureQutput [1.1] string 
=) Eg ResultSetl [0..*] Result Set Row | [e] Employeeto oa 
aaa a9 aie ny oon = | [e] FirstName [1.1] string 
— [e] LastName [1.1] string 
— FIRSTNME [1.1] VARCHAR Move + * [| Department [1.1] string 
BE LASTNAME [1.1] VARCHAR et Move + oS [be] ProjectNo [1.1] string i 
= WORKDEPT 1.4) CHAR _| [e] ProjectName [1.1] string 
=) Fg} ResultSet? [0..*] Result Set Row 
a= DEPTNO [1.1] CHAR 
B DEPTNAME [1.1] VARCHAR PY "e|Move ~ 
=) Fe ResultSet3 [0..*] Result Set Row 
f PROJNO [1.1] CHAR PY EjMove ~ 
=) Fe} ResultSetd [0..*] Result Set Row 
— PROJNAME [1.1] VARCHAR PY "Ej Move ~ 





__ 37. Save the map with Ctrl+S and close it. Sh gee 


‘. StoredProcedures_Flow_Mapping <i i. 
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__ 38. Connect the nodes in the flow as shown, and save it with Ctrl+S. sae 






4 3 Palette 


ams JMS 

(a HTTP 

Las Web Services 
(ol, SCA 

igi: WebSphere Adapters _ 
> Routing | 
(at NET 

ee Transformation  < 





__ 39. Close the message flow. 
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3.4.3 Deploy and test application 


You will now be deploying and testing the created application. 


Please note that the Integration Node requires a Configurable Service for the JDBC 
connection to the database. This is already created. The steps to create it are documented 


in the Appendix to this lab. 


Application Development 


Mapping_DB_Read 
Stored Procedures 


Ea 


Flows 











fe Maps 

@) References 

= StoredProcedures Lib 
(™y Other Resources 

=, Mipping_Lib 


Independent Resources 
seneratedBarFiles 
storedProceduresDDP 





» EeConfigurable Services 
4 default 
» &&] Mapping_DB_Read 
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Eel StoredProcedures_Flow.msgflow 


New... 


1. Click on the Integration Node tab to view the running node. Deploy the Stored_Procedures 
application to the default Integration Server. 
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__2. — Confirm the deployment by expanding the default Integration Server. 


is Integratio I Data Sourc| ts. Data Proje | 






2 Integration Nodes 
fi) IBINODE 
(4% Configurable Services 
fe, default 
fs] Mapping_DB_Read 
fs) Stored_Procedures 
Fis] StoredProcedures_Flow 
“= StoredProcedures_Flow_Mapping 
ms, StoredProcedures_Lib 
Employee_SP 


__ 3. Now that the application is deployed, you will use the Integration Bus embedded Test Client. 
Right-click on the Stored_Procedures application and from the drop-down menu select Test.... 





10 fegratiar 


File Edit Flow View Tha mH. . tame oor 7 —_ -4 - 
New r 
Manage Library references 
Manage included projects 
Focus on Application 


Convert to Library 
Export ASDs from Application 
Migrate 


Go Into 

4 |] References 

> EBA StoredProc Copy 

[ Fi Other Resource Paste 
i, Mapping_Lib Delete 
4 BA StoredProcedures 

> (=. Schema Defini 

» WY Other Resourc Rename... 
F Independent Reso 








Import... 

> j=? GeneratedBark 
= Corn Export... 

> [= StoredProced 
Refresh 


w Integratio a: 





Build for masipackagebar 


2 Integration Node: E ony ! 


J Tnnaamer 
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_ 4, In the opened Test client, right-click on the Body table and click Add Message Part. 





Els xe os 
Events 


i Select the message flow you would like to test. Click Send Message to run. 
Message Flow Test Events > General Properties 


rales FlBear ~DetailedProperties 
[EY Invoke Message Flow Message flow: | /Stored_Procedures/StoredProcedures_Flow.msgflow + 

















Input node: ‘MQ Input wl 
Message 





> Header 


Body: | Edit as XML structure zi 


Name Type Value 


[Add Message Part_} 


Remove Message Part 








Change Message Part 


Set Value... 
Unset 

Set to Null 
Reset to Default 





Add Element 








Copy Value Ctrl+C 


Saved Ad Valueto Pool. Send Meson 


Use Value from Pool... 

















Events | Configuration Replace Value from Pool... 


a = Paste Value Ctrl+V —— 
© Properties | [2 Problems | 5= Outline | 4] Tasks | FA Deployment Log \ EB @~ 0 
Select All Crtl+A 
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__ 5S. From the Type Selection, select Employee and click OK. 


(it) Type Selection 


Choose a type (? = any character, * = any string): 


Matching types: 


EmployeeData 


Qualifier: 


fe http://(www.example.org/Employee 
ps Bp py 
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__6. The message body will open as an XML structure. In the Value column, change the default 
value (EMP_NUM) to the number ‘000070’. Once done, it should appear as follows: 








El*Stored: Proced ‘es.mbtest 2-5 ~ | 
Events 
i Select the message flow you would like to test. Click Send Message to run. 
Message Flow Test Events > General Properties 
Palpeelaen ~ Detailed Properties 
[EF Invoke Message Flow Message flow: | /Stored_Procedures/StoredProcedures_Flow.msgflow + 
Input node: | MQ Input 2 
Message 
> Header 
Body: | Edit as XML structure - 
Name Type Value 


4 Employee Employee = 
EMPL_NUM string 


Saved Messages | | Show Generated Source... | Send Message | 











__7. Click Send Message. 


__8. — Confirm the deployment to the default Integration Server and click Next. 


(i select Deployment Location 


opecify deployment details 


This server instance is currently running. 








Deployment location: 


a 2 Integration Bus v9.0 
4 <4 IBSNODE 
is default | Connect to Remote Integration Node... 


New Local Integration Node... 


[| Trace and debug 
Stop at the beginning of the flow during debugging 
Always use the same deployment location for every test run 
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__9. | Onthe next screen, increase the default wait time for deployment to 120 as shown. Click 
Finish. 
(ik) Select Deployment Location 


opecify Test Settings 
Determine the settings of the test environment. 














Test Engine Settings (Apply to All Test Executions) 
Seconds to wart for deployment completion 


Seconds to wart after Test Client complete the deployment 0 

Seconds to wart on launching the debugger for tracing purpose 20 

("| Show information dialog before disconnecting debugger. 

Seconds to wait for test client to stop 120 

(| Create queues of input and output nodes of message flows when host name is localhost 
("| Add or modify (but not clear) what has already been deployed on the execution group 











Next » Finish 








__ 10. It may take a couple of seconds, and once the call is completed you should see the response 
from the database with the details for the employee with number ‘000070’. 





Events 


Message Flow Test Events 


a se | 2 ry 
IEF Invoke Message Flow st: localhost 
v Message flows deployment successfully completed 
Ye Starting 
c 4 Sending Message to MQ Queue "STORED.PROCEDURE! Server channel: SYSTEM.BKR.CONFIG 
2. MQ Queue Monitor "STORED.PROCEDURES.OUT" 
E)\, Stopped listening for response 
Stopped Queue: STORED.PROCEDURES.OUT 


0 
Queue manager: IB9QMGR 


Message 


>» Header 


View as XML structure ¥ 


Name Value 

4 io:EmployeeData 
xmins:io http://www.example.org/Employee 
io:ProcedureOutput This is an IB9 Workshop Demonstration! 
io:EmployeeNo 000070 
io:FirstName EVA 
io:LastName PULASKI 
io:Department ADMINISTRATION SYSTEMS 
io:ProjectNo AD3110 
io:ProjectName GENERAL ADMIN SYSTEMS 











4 | 








Events | Configuration | 
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__11. Feel free to run the test again using different employee number. Right-click on Invoke Message 
Flow and click on Duplicate. 


























Events 
Message Flow Test Events >» General Properties 
> e|\> FF BER ~ Detailed Properties 
4 [EF Invoke Message Flow | Message flow: | /Stored_Procedures/StoredProcedures_Flow.msgflow a 
v Message flows de Re-run ; = 
Inputnode: | MQ Input | 
4 ' Starting Invoke — 
’ Message 
Duplicate 
a! n > Header 
: Rename 
Ej, Stopped listen Body: | Edit as XML structure ¥ 
@ Stopped Remove _ : > 
Name Type Value 
Remove All | 
Employee Employee 
ee ERE EMPL_NUM string 000070 














__12. Inthe Value column put the number ‘000010’ and click on Send Message. 





Events 


i Select the message flow you would like to test. Click Send Message to run. 
Message Flow Test Events > General Properties 


Pal|\@> SF Fl|BB ——— 
[EF Invoke Message Flow Message flow: '/Stored_Procedures/StoredProcedures_Flow.msgflow 
v Message flows deployment successfully completed 
Ye Starting 
2 Sending Message to MQ Queue "STORED.PROCEDURE’ 
@ MQ Queue Monitor "STORED.PROCEDURES.OUT” » Header 
@ Stopped 
IEF Invoke Message Flow Name Type Value 
E 


4 Employee mployee —E 
EMPL_NUM string ce | | ] 











Input node: | MQ Input 


Message 











Show Generated Source... 

















Events | Configuration 
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__13. You will receive the response for this employee. 





Events 


Message Flow Test Events 


rae|\> 2 F| BSR 
[EF Invoke Message Flow . localhost 
v Message flows deployment successfully completed 
Ye Starting 0 
4 Sending Message to MQ Queue "STORED.PROCEDURE! Server channel: SYSTEM.BKR.CONFIG 
42. MQ Queue Monitor "STORED.PROCEDURES.OUT" 
Ei, Stopped listening for response 

















Queue manager: IB9QMGR 





@ Stopped Queue: STORED.PROCEDURES.OUT 
IEF Invoke Message Flow Message 


vv — flows deployment successfully completed » Header 
Ye Starting 
#2. MQ Queue Monitor "STORED.PROCEDURES.OUT" ———OOOooOoOoOoOoOoOoOoOooOoOoOoo 
Ej}, Stopped listening for response : Name Value 
@ Stopped 4 io:EmployeeData 
xmins:io http://www.example.org/Employee 
io:ProcedureOutput This is an IB9 Workshop Demonstration! 
io:EmployeeNo 000010 
io:FirstName CHRISTINE 
io:LastName HAAS 
io:Department SPIFFY COMPUTER SERVICE DIV. 
io:ProjectNo AD3100 MA2100 MA2110 
io:ProjectName ADMIN SERVICES 
































Events Configuration 


__14. Close the Test Client. Do not save it. 
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3.5 Clean up 


We will remove all of the assets that we have deployed. 





1. Remvove the deployed applications. Right-click on the default Integration Server and select 
Delete All Flows and Resources. 
fn Integration Nodes 2-1 hee Data Source Explor ~ / meee = 
# Oo Si" Start by 
4 2 Integration Nodes A Servic 
F IESNODE resource 









F) Properties £2 [2 Probler 


Property 


| 3 All Flows And Resources 





Launch Debugger (Port is 14999) Pll Pi init ea ts 





This completes lab 3. 
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3.6 Appendix - JDBC configuration 


The Mapping Node uses JDBC to connect to a relational database. The following commands and 
configuration are included for reference. This configuration has already been done on the VMWare 
image, So you do not need to execute the command in this section. 


= oN Set the security parameters to allow the Integration Node to connect to the SAMPLE database. 
mgsisetdbparms IB9NODE -n jdbc::SAMPLE -u admin -p oneclick 


__2. Specify the JDBC security parameters to allow a message flow using the SAMPLE database to 
connect successfully. 


mgsisetdbparms IB9NODE -n jdbc::mySecurityId -u admin -p oneclick 


__3. Create the configurable service which will use the “mySecurityld” database connection (the 
command Is saved in c:\student\Mapping_database\install\DBSetup\createJ DBCConnections.cmd): 


mgsicreateconfigurableservice IB9NODE -c JDBCProviders -o SAMPLE -n 
connectionUrlFormat,connectionUrlFormatAttrl,connectionUrlFormatAttr2,c 
onnectionUrlFormatAttr3,connectionUrlFormatAttr4,connectionUrlFormatAtt 
r5,databaseName, databaseType, databaseVersion, description, environmentPar 
ms, JarSURL, ]dbcProviderXASupport ,maxConnectionPoolSize,portNumber, secur 
ityIdentity, serverName, type4DatasourceClassName,type4DriverClassName = - 
- 

"I dbc:db2:// [serverName] : [portNumber] / [databaseName] :user= [user] ;passwo 
rd= (password). ls SAMPLE 3 DBZ Universal 
Database","10.1","default Description", "default none","C:\IBM\SQLLIB\ja 
va" "truet. "0", "50000", "mMmySecurityld" "localhost ,-"com.ibmdb2.7ec.DB2Xx 
ADataSource","com.ibm.db2.jcc.DB2Driver" 


Alternatively, you can create it in IB Explorer. 


At a minimum, the following parameters should be changed. This example is for DB2 (local instance). 


Name: SAMPLE 
Type: JDBCProviders 
Template: DB2 


databaseName: SAMPLE 
jarsURL: c:\IBM\SQLLIB\java = (or wherever DB2 has been installed) 
securityldentity: mySecurityld 


serverName localhost 
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“Type 


Contiqurable Service 


Modify a Configurable Service's attributes 


‘Name SAMPLE 


JDBCProviders 


Template | SAMPLE 


Key 
connectionUrlFormatAttrs 
databaseSchemaNames 
databasel ype 
databaseVersion 
description 
environmentParms 
jarsURL 
jdbcProviderAASupport 
maxConnectionPoolSize 
portNumber 
securityldentity 


serverName 


type4DriverClassName 





typed DatasourceClassNa... 


Value 


SAMPLE 
wseProvidedSchemaNames 
DE? Universal Database 
10.1 
default_Description 
default_none 
CAIBM\SQLLIB\ java 
true 

0 

50000 

mySecurityld 


localhost 


comuibm.db2 jcc. DB2sxADataSource 


com.ibm.db2jcc.DB2Driver 
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4. This will result in a new configurable service as shown below: 











a €> IBM WebSphere MQ 
4 (& Queue Managers 
> 3 IB9QMGR 
> J QMGR2 
(& Queue Manager Clusters 
(& JMS Administered Objects 
(& Managed File Transfer 
(& Service Definition Repositories 
4 dg Integration Nodes 
4 & IB9NODE 
4 Z, default 
Get_Balance 
» &§) Mapping_DB_Read 
> Gi Resource Managers 


4 @& Configurable Services 

‘}) DecisionServiceRepository/Default 

(|) JDBCProviders/SAMPLE) 

}) JMSProviders/IBM_MessageSight 

\) WorkloadManagement/WorkloadManagementT empl 
u Administration Queue 

> @& Broker Archive Files 











oBY oO MQ Explorer - Content <a q 





Configurable Service SAMPLE 





Properties QuickView: 
Name SAMPLE 
Type JDBCProviders 
connectionUrlFormat jdbc:db2://[serverName]:[portNumber]/[datab. 


connectionUrlFormatAttrl 
connectionUrlFormatAttr2 
connectionUrlFormatAttr3 
connectionUrlFormatAttr4 
connectionUrlFormatAttrS 
databaseName 
databaseSchemaNames 
databaseType 
databaseVersion 
description 
environmentParms 
jarsURL 
jdbcProviderxXASupport 
maxConnectionPoolSize 
portNumber 
securityldentity 
serverName 
type4DatasourceClassName 
type4DriverClassName 





SAMPLE 
useProvidedSchemaNames 
DB2 Universal Database 
10.1 

default_Description 
default_none 
CAIBM\SQLLIB\ java 

true 

0 

50000 

mySecurityld 

localhost 
com.ibm.db2.jcc.DB2XADataSource 
com.ibm.db2.jcc.DB2Driver 


_ 5. Stop and restart the default execution group, or the Integration Node. 


mgsistop IB9NODE 


mgsistart IB9NODE 
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Lab 4 Decision service node 


4.1 Introduction to IBM Operational Decision Management 


IBM Operational Decision Manager integrates business events and business rules to automate decisions 
across processes and applications. It improves the quality of transaction and process-related decisions 
that are made repeatedly, determining the appropriate course of action for each customer, partner and 
internal interaction. 


The IBM Operational Decision Manager modules 


IBM Operational Decision Manager comprises a set of modules that operate in different environments, 
but also work together to provide a comprehensive decision management platform. 


e Rule Designer — is an integrated development environment (IDE) for rule applications that 
integrates directly into the Eclipse family of integrated development environments, including Eclipse, 
IBM Rational Application Developer (RAD) and ISM Rational Software Architect (RSA). Rule 
Designer is used by developers and architects to develop and integrate business rule sets into 
applications. 


e Rule Execution Server — is a robust, J2SE and J2EE-compliant execution environment for 
deploying business rule SOA services to the leading web and application servers such as 
WebSphere Application Server. The Rule Execution Server includes components for synchronous, 
asynchronous and web service-based invocation of business rules and includes a web 
administration console. The Rule Execution Server is fully integrated with the Rule Designer and 
Decision Center to support business rule deployment for both developers and policy managers. 


e Decision Center — A scalable rule management server and repository with a collaborative web 
environment for authoring, managing, validating and deploying business rules. Decision Center 
provides project governance, including role-based security, history maintenance and custom 
metadata. Decision Center provides enhanced collaboration between teams through multi-user 
access for business users and synchronization between IT and business user environments. 


e Rule Solutions for Office — is used for offline authoring and sharing of the business rules using 
standard office tools. Rule authors write rules in Microsoft Word and edit decision tables in Microsoft 
Excel. They can create mixed rule and non-rule content in a RuleDoc, and retain semantic 
information together with the actual implementation content of the rules. 
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Rule application development Rule management and authoring 
i 
© ! 
fi aid Buswess analyst | 
i“ : Rule author Policy manager eer 
Developer st synchronize Review 
Author = Validate 
Test Administer 
— Deploy of yr Deploy 
Designer pe Decision Center 
yy" Administrator 
¥ 
Integrate 
if Hb F 
| | Audit | 
Developer Rule Runtime Administrator 


Enterprise applications 


Two categories of users are involved in developing and maintaining a decision management solution: 


IT users 


Architects, developers and administrators develop and maintain the rule application. Developers work 
with Rule Designer in Eclipse for design, Java development and rule project development. Using 
Decision Validation Services, they can also test rule sets against real or fictitious scenarios to support 
and troubleshoot problems found in Decision Center. 


Business users 


e Business users work with Decision Center to write and maintain business rules, both during 
application development and after the application is deployed to production. 


e Business users can perform end-user testing and simulation in Decision Center. Business analysts 
can simulate business outcomes, run updated rules against historical data, simulate expected 
changes in data profiles against existing rules, and analyze aggregate outcomes. 


e Policy managers and other business users can use Rule Solutions for Office to author rules, in a 
familiar environment. RuleDocs are Microsoft Office documents that contain business rules. 
Business users can publish RuleDocs from Decision Center, edit the RuleDocs in Word or Excel, and 
update their changes back into Decision Center. 


e RuleDocs can be published to any WebDAV server and can be short-lived or managed in a content 
management system such as SharePoint. 
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4.2 Rules in IBM Integration Bus — Decision Service node 


IBM Integration Bus V9.0 includes a subset of the IBM Operational Decision Management solution. The 
IBM Integration Bus runtime includes the rules execution server, handling rules only (not business events 
too). The IBM Integration Bus Toolkit includes a new node, called the Decision Service node, which 
executes the business rules, and also includes an editor for creation of those business rules. 


Alternatively, you can use IBM Operational Decision Management Decision Center to do rule authoring, 
and use those rule sets with the IBM Integration Bus Decision Service node. You can also use the IBM 

Integration Bus Decision Service node to call business rules execution on an external IBM Operational 

Decision Management Rule Execution Server. 


Rules in IBM Integration Bus 


You can use IBM Integration Bus to write business rules by using natural language, so that they can be 
read easily by business users (for example, a business analyst). In IBM Integration Bus, you create a 
decision service, which is a collection of rules that are used to process a message. A Decision Service 
node executes those business rules to provide operations like routing, validation and transformation. 
You can either write rules in the IBM Integration Toolkit, or import rules from IBM Operational Decision 
Management. You can also retrieve rules from an external IBM Operational Decision Management 
repository. 


The Decision Service node allows IBM Integration Bus to call business rules that run on a component of 
IBM Decision Server that is provided with IBM Integration Bus. The IBM Integration Bus license entitles 
you to use this component only through the Decision Service node and only for development and 
functional testing. To use the IBM Decision Server component beyond development and functional test, 
you must purchase a separate license entitlement for either IBM Operational Decision Management 
Decision Server (the full external server) or IBM Operational Decision Management Decision Server 
Rules Edition for Integration Bus (the rules only server included in IBM Integration Bus). 


A business rule is a required operation that applies to a specific set of business conditions. For example, 
you Can create a business rule that offers a discount to customers who spend more than a certain 
amount. The business rule can be modified in the future if the business climate changes and the amount 
of discount must change. 


You can use business rules to update the business logic that is applied to message processing as 
business conditions change. Here are some examples of the capability that business rules can provide. 


Routing 


Business rules provide smart, dynamic routing in the message flow that is based on the business 
content of the message. For example, business rules can control least cost routing: if a customer 
places an order, business rules can be used to determine which facility is the most appropriate to 
fulfill that order. This decision can be based on the types of item that are ordered, the location of 
the customer, and the required speed of delivery. 


Validation 


Business rules provide message validation that is based on the business content of the message; 
for example, business rules can provide content validation. If an account number starts with 
ABC, the next four characters must be numbers. But if the account number begins with XYZ, the 
account number must contain five numbers. 
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Transformation 


Business rules can be applied to message content to modify the values in that message. For 
example, you can change the discount that is offered to a customer when certain conditions are 
met, such as a purchase above a certain amount. 


Consider an example of a business rule where customers who spend a lot of money in a single 
transaction are provided an upgrade. 


To create business rules, first specify the vocabulary that is required to express the policy, and then 
represent the logic of the business policy as "if-then" statements. In IBM Integration Bus, you use a 
Decision Service editor to specify the parameters that form the vocabulary for writing rules. A typical 
parameter is shown in the following example. 


Type Verbalization 


myCustomer CustomerType The customer 





If you already have a decision service file, you can drag it on to a Decision Service node or use the node 
properties to locate it. Alternatively, you can double-click the node or use menu options to create a 
decision service by using a wizard. When you import a rule application archive from IBM Operational 
Decision Management, it is converted to a decision service, which you can associate with a Decision 
Service node. You cannot use the IBM Integration Toolkit to view or edit the rules that you import from 
IBM Operational Decision Management. 


Business rules act on business objects, such as a customer. This business object is represented by an 
XML schema. IBM Integration Bus supports rules that are created from XMLNSC or DFDL schemas. 
For decision services that you create in IBM Integration Bus, you write the business rules in the Decision 
Service editor by using the vocabulary that you define. The following example shows how natural 
language parameters are used in the Decision Service editor to implement the business policy: 


if 

the category of the customer is Gold 

and the value of the shopping cart of the customer is more than $1500 
then 

set the category of the customer to Platinum 


Rules are written by using the Business Action Language (BAL). 


These parameters and rules are contained in a decision service (.rules) file that can be deployed. When 
you deploy a BAR file that contains a decision service that you created in the IBM Integration Toolkit, the 
decision service is compiled into a rule set (.ruleset). Imported rules contain compiled rule sets. In the 
form of a decision service, the business logic can be called from the message flow as a business rule 
application. Therefore, changes to the business policy do not require changes to the message flow. 
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You can write rules in the IBM Integration Toolkit and at run time retrieve them from the local application, 
library or Integration project. You can also import business rules that were written in IBM Operational 
Decision Management and retrieve them from an IBM Operational Decision Management repository at 
run time. A configurable service is provided for you to specify connection details. 


Structure of a business rule 
A business rule expresses business logic by using a rule syntax that represents natural language. 


A business rule typically consists of the following information, in the order specified: 
1. Definitions 


2. Conditions 
3. Actions 
Definitions 


At the beginning of the rule, you can set parameters that identify business terms by using easily 
understandable names. You can set these parameters by using the New Decision Service 
wizard. 


When you specify the parameters, either by using the New Decision Service wizard when you 
create the decision service, or by adding them later in the Decision Service editor, you can then 
refer to those parameters from all the rules in the .rules file. If you create a parameter in the 
definitions section of a specific rule, that parameter is available to that rule only. 


Here is an example of a definition: 
definitions 
set minimum_cart value to $1500 
Conditions 


The conditions section of the rule contains the "if" statements. These statements define the 
conditions under which actions are completed. If the condition is true, the action is completed. A 
rule can contain one or more condition statements. 


Here is an example of a condition section that contains two condition statements. 
if 
the customer's category is Gold 
and the value of the customer’s shopping cart iS more than minimum_cart_value 


The second condition statement uses the variable that was set in the definitions section. The 
action is completed if both statements are true. 


Actions 


The actions section of the rule contains the "then" statements. These statements define the 
actions that are taken when the conditions that are represented by the "if" statements are met. If 
the actions section contains more than one action, the actions are taken in the order in which they 
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are written. You can also include "else" statements in the actions section. These statements 
define what actions to take if the conditions are not met. 


Here is an example of an action statement: 


then 


change the customer's category to Platinum 


4.3 Building the business rules 


__1. — If not already open, start the IBM Integration Bus Toolkit by double-clicking its desktop icon. 
Enter c:\Student\DecisionService\workspace as the workspace and select OK. 


Select a workspace 
IBM Integration Toolkit stores your projects in a folder called a workspace. 


Choose a workspace folder to use for this session. 


Workspace: 


| Use this as the default and do not ask again 





lf already open, select File>Switch Workspace> Other... to get the workspace selection 
dialog, and then enter (or use Browse) c:\Student\DecisionService\workspace as the 
workspace and select OK. 


2. | The workspace has an Application named Passenger already created, which has an XML 
Schema file already loaded. 


Application De ¢- te, Patterns Explo | ~ O 
FES” 
Application Development New... 


F] Passenger 
4 (=. Schema Definitions 
F et (default namespace) 
[5] passenger.xsd 
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3. Click on the Passenger Application to highlight it. Then click the New... link in the Application 
Development view, and then click Decision Service to create the business rules. 


fea Application De x a as Patterns Explo =m 
26@EBs” 


| Application Development 
New Artifact 





Passenger 
Schema Definitions 


fe (default namespace) 


Message Flow 
[S| passengernssd Eig subflow 
=F Message Model... 


fret Message Map 


Ce Decision Service 
ii MQ Service 
Fly Database Service 


Quick Start 


Start by creating an integration service 


4 Start by creating a library 
§° Start from WSDL and/or XSD files 


to Integration N £3 * IMS Data Source Ex Si" Start by discovering a service 
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4. _ Ensure the Container is Passenger. Enter Passenger_Decision_Service as the Decision 
service name and click Next. 


| (i) New Decision Service 


Create a decision service a 


A decision service & a collection of one or more business rules 


Container: [Passenger | ; 


Decision service name: 
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__5. Click on Passenger, then DFDL and XML Schemas to open the folder of known Schemas. 
Click the box for Passenger {}. Click Finish. 


(i) New Decision Service - —s 


Decision Service Parameters 


Select the parameters available to the decision service. 
Filter parameter names (? = any character, * = any String): 


Select parameters 


Passenger 
4a (2 DFOL and AML Schemas 
P| Le] CustomerName {} 


p> (Primitive datatypes {http://www.w3.org/2001/AMLSchema} 


Physical Location: 














Application: Passenger 
Path: [> passengerxsd 





6. 


— = — 3 — 
Passenger_Decision_ Seniceules ci 


Use the table below te customize the parameters available to the decision service, 


Decision Service Parameters | >< | 


Name Type Direction Verbalization 
Passenger Passenger {} INOUT Passenger 


Rule sequence | Parameters | Additional Info 
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__f. Click on the Rule sequence tab. 





Use the table below to customize the parameters available to the decision service. 


Decision Service Parameters | >< | 


Name Type Direction Verbalization 
Passenger Passenger {} INQUT Passenger 





= 
Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


& ‘Rule 1' is empty. 


~ Rulel 














Rule sequence | Parameters | Additional Info 
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__9. ~— Click in the Rule 1 window. Type if (if followed by a space). Content assist will pop up. 


pees *Passenger Decision Service.rules x ~ 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 


& if 


Documentation: 
Use this construct to test whether the enclosed 
conditions are all true. Enclosed conditions are Boolean 
expressions that are introduced by a'-’, 
@ false 


(its not true that <condition> 


= none of the following conditions are true: 


@ Passenger 

“ithe customer name of <a passenqger> 
“ithe length of <a string> 

= the number of <term> 


“@the number of elements in < objects> 


"a the price of <a passenqer> ee 





__10. Now double-click on all of the following conditions are true:. Press Enter. 





Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 
ea if all of the following conditions are true : 


= - <condition> 
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__11. Double-click on the customer name of <a passenger>. 


oe *Passenger_Decision_Service.rules o ‘ 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rule l 





if all of the following conditions are true : 


ie a 


{ 


all of the following conditions are true: 


any of the following conditions is true: 


false 


rt not true that < condition> 


= none of the following conditions are true: 


® Passenger 
(the length of <a string> 
= the number of <term> 


“@ithe number of elements in < objects> 


| |Phrase: 
the customer name of <@ passenger> : string 


“athe price of <a passenqger> ‘al 


__12. Double-click Passenger. 








= *Passenger_Decision_Service.rules xe 





Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rule l 


if all of the following conditions are true : 
es - the customer name of 


Variable: 
Passenger : passenger 
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__13. Double-click on contains... 


eB *Passenger_Decision_Service.rules 23 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 














~ Rulel 





if all of the following conditions are true : 
& - the customer name of Passenger 


Phrase: 
<a string> contains <a character> : boolean 


°@ does not start with... Returns whether the string contains the character 


°@ends with ... —— 


@is <an object> 
@is empty Phrase: 
@is not <an object> <a string > contains <a string > : boolean 


@is not empty Documentation: 
@is not null Returns whether the first string contains the second 


@is not one of <objects> 
@is null 








__14. Double-click <string>. 


“Passenger Decision Servicerules £2 \ 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 











v Rule l 








if all of the following conditions are true : 
xX) - the customer name of Passenger contains 


°@the length of <a string> 
= the number of <term> 
°@the number of elements in <objects> 


°@the price of <a passenger> 
°@the status of <a passenger> 
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__15. The editor creates a set of double quotation marks. Type Jones between the quotation marks. 





ae assenge Decision Service.rules x 





Author one or more rules that will make up your decision service. 


Press CTRL + SPACE to use content assist. 





* Rule l 
if all of the following conditions are true : 
a —- the customer name of Passenger contains "" 
a 


__16. Move the cursor past the end quotation mark and press Enter. You should be on a new line. 





z = 
_ — Ue 
“ly FPoOSsEriger VELIShOT) SErWILe. Pues ce. 





Author one or more rules that will make up your decision service. 


Press CTRL + SPACE to use content assist. 


* Rule l 





if all of the following conditions are true : 
—- the customer name of Passenger contains "Jones" 


Ws 
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__17. Press CTRL-Space to invoke Content Assist again, and double-click on <condition>. 





Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 


if all of the following conditions are true : 


- the customer name of Passenger contains "Jones" 


= - <condition> 
and <condition> 
is «an object> 


is not <an object> 





is not one of <objects> 
is one of <objects> 





or <condition> 
= then 





Rule sequence) Parameters | Additional Info 





Lab 4 — Decision service node Page 207 


IBM Software 


__18. Double-click on the status of <a passenger>. 


oe *Passenger Decision _Service.rules a 


Author one or more rules that will make up your decision service, 
Press CTRL + SPACE to use content assist. 


* Rule 1 


if all of the following conditions are trae : 
- the customer name of Passenger contains "Jones" 


an ER: = ‘Phrase: 
on is not true that <condition= the status of <0 passenger : string 
= none of the following conditions are true: 


@ Passenger 
“ithe customer name of <a passenger> 
“@the length of <a string> 

= the number of <term> 


“@the number of elements in <ebjects> 





= there are <a number> 


= there are at least <a number> 
4 = 
= f 


here are at most <a number> 





Rule sequence) Parameters | Additional Info 








Page 208 Discovering what is new in IBM Integration Bus v9.0 


IBM Software 


__19. Double-click on Passenger. 


GR *PassengerDecisionServicerules 


Author one or more rules that will make up your decision service, 
Press CTRL + SPACE to use content assist. 


if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of 
: hae Passenger: passenger 





Add Rule 





Rule sequence | Parameters | Additional Info 
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__20. Double-click on contains... 


fe *Passenger_Decision_Service.rules 23 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 





~ Rule l 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger 
= ’ : 1 Phrase: 
: <a string> contains <a character> : boolean 


PP 


vA 


°@ does not start with ... Returns whether the string contains the character 


“@ends with... a 


@is <an object> | 
@is empty Phrase: 
@is not <an object> <a string > contains <a string> : boolean 


@is not empty Documentation: 
@is not null Returns whether the first string contains the second 
@is not one of <objects> 

3) is null 











Rule sequence | Parameters Additional Info| 








21. Double-click on <string>. 


=. 
fe *Passenger_Decision_Service.rules 23 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 





~ Rulel 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains 


& = 


oA 


aithe customer name of <4 passenger 
°@the length of <a string> 
= the number of <term> 
°*@the number of elements in <objects> 


| °@the price of <a passenger> 
°@the status of <a passenger> 











Rule sequence | Parameters Additional Info 
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__22. Type Silver between the double-quote marks, and then move the cursor past the end quotation 
mark and press Enter. 


oo 
& «oD 


cP | 6 FeaSsenge 


, | J] | =C)5 Ti #] | gil | ati Eb Pues _ = : 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 








if all of the following conditions are true : 
- the customer name of Passenger contain "Jones" 






- the status of Passenger contains "Silver" 
——— a 








Add Rule 
Rule sequence | Pararneters | Additional Info 
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__ 23. Again press CTRL-Space to invoke Content Assist, and double-click on <condition>. 


Ce *Passenger_Decision_Service.rules 23. 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule 1 


if all of the following conditions are true : 
—- the customer name of Passenger contains "Jones" 


— the status of Passenger contains "Silver" 


“ fe econdition= | 
@and <condition> 
iis san object> 


is not <an object> 

@is not one of <objects> 
iis one of <objects> 
or «condition> 


= then 





Rule sequence Pa rameters | Additional Info| 
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__ 24. Double-click the price of <a passenger>. 


= *Passenger_Decision_Service.rules a = 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule 1 


af all of the following conditions are true : 
—- the customer name of Passenger contains "Jones" 


—- the status of Passenger contains "Silver" 


= aR ; ——— |Phrase: 
= any of the following conditions ts true: ‘ 
the price of <a passenger> : number 
@ false 


fit ts not true that <condition> 

= none of the following conditions are true: 
@ Passenger 
“ithe customer name of <a passenger> 
“@the length of <a string> 


= the number of <term> 


(ithe status of <a passenger> 


= there are <a number> 





Rule sequence | Pararneters | Additional Info | 
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__ 25. Double-click on Passenger. 


Ce *Passenger_Decision_Service.rules ini © — oOo 


Author one or more rules that will make up your decision service, 
Press CTRL + SPACE to use content assist. 


* Rule 1 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of 


: passenger 





Rule sequence | Parameters | Additional Info 
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__26. Double-click Is at least... 








Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 





v Rule l 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of Passenger 
Phrase: 

ee »|| <a number> is at least <a number> : boolean 

@ equals <a number> 


ad 


Documentation: 
Returns whether the first numeric value is greater than or 
equal to the second 


a 


@is between <min> 


@is less than <a number> | |Phrase: 
| <a number> is at least <min> and less than <max>: 


boolean 


°@is more than... 
@is not <an object> 
4 @is not one of <objects> 
@is one of <objects> Documentation: 


@)is stric 











Rule sequence | Parameters 


27. Double-click on <numbers>. 





te *Passenger_Decision_Service.rules £3 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 





v Rulel 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of Passenger is at least 
& Value: 
0: number 





= the number of <term> 
°@the number of elements in <objects> 
°@the price of <a passenger> 








Rule sequence Parameters 
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28. 


Page 216 


A zero (0) will be inserted, and the cursor will be placed over it. Type 7500 and a space as the 


new value, replacing the 0. 


[oan 


af “PassengerDecision_ Servicerules oi. 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 


if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of Passenger is at least fi 


Rule sequence) Parameters | Additional Info 
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29. The editor should look as follows at this point, with content assist popped up due to typing the 
space. Double-click and <condition>. 





= *Passenger_Decision_Service.rules xy 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rule 1 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of Passenger is at least 7500 
& = Piwane: 
: <condition > and <condition> : boolean 





Documentation: 


@is <an object> Returns whether both conditions are true 


@is not <an object> 
@is not one of <objects> 





@is one of <objects> 
@ or <condition> 
= then 


Rule sequence | Parameters | Additional Info | 








30. Double-click less than <max>. 





a *Passenger_Decision_Service.rules x 





Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rulel 


if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of Passenger is at least 7500 and 
T Phrase: 

: ; a <a number> is at least <min> and less than <max> : 
> all of the following conditions are true: boolean 


= any of the following conditions is true : 


or 
uyit iyi! 


i 


Documentation: 
Returns whether the first numeric value is greater than or 
equal to the second and smaller than the third 





none of the following conditions are true: 
@ Passenger 
°@ the customer name of <a passenger> 
< °@the length of <a string> 
= the number of <term> 
*@the number of elements in <objects> 








Rule sequence Parameters | Additional Info 
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31. Double-click on <numbers>. 





ee *Passenger_Decision_Service.rules x : 





Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rule l 


if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 


- the price of Passenger is at least 7500 and less than 
& : —_ : Value: 
0: number 


@the length of <a string> 

= the number of <term> 
°@the number of elements in <objects> 
°@the price of <a passenger> 








Rule sequence | Parameters | Additional Info 
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__32. Type 10001 and press Enter. 





Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 





Shue 1 


if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 





—- the price of Passenger is at least 7500 and less than 10001” 
SEE 





Rule sequence) Parameters | Additional Info 
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__ 33. Press CTRL-Space to invoke Content Assist again, and double-click on then. 


te *Passenger_Decision_Service.rules ¢4 aN 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule 1 


if all of the following conditions are true : 
—- the customer name of Passenger contains "Jones" 


—- the status of Passenger contains "Silver" 


— the price of Passenger is at least 7500 and less than 10001 


= - <condition> 

and <condition> 

iis <an object> 

iis not <an object> 

is not one of <objects> 


is one of <objects> 





Rule sequence | Parameters | Additional Info 
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__34. Double-click set the status of <a passenger>. 


= *Passenger_Decision_Service,rules i-5 os & 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rule 1 


if all of the 
—- the 


— the 


—- the 


set 





following conditions are true : 
customer name of Passenger contains "Jones" 


status of Passenger contains "Silver" 
Price of Passenger if at least 7500 and less than 10001 


Phrase: 
set the status of <a possenger> to <a string> 


Rule sequence | Parameters Additional Info | 
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__ 35. Double-click Passenger. 


Ce *Passenger_Decision_Service.rules ¢-4 


= 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


~ Rule l 








if all of the following conditions are true : 
-—- the customer name of Passenger contains "Jones" 


—- the status of Passenger contains "Silver" 
- the price of Passenger is at least F500 and less than 10001 


Gs then set the status of 


iii : passenger 





Rule sequence) Parameters | Additional Info 





Page 222 Discovering what is new in IBM Integration Bus v9.0 


IBM Software 


36. Double-click to <a string>. 








Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 








if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 
- the price of Passenger is at least 7500 and less than 10001 


then set the status of Passenger 





set the status of <a passenger> to <a string> 





Rule sequence | Parameters 


37. Double-click <string>. 








Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 





~ Rule1 





if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 
- the price of Passenger is at least 7500 and less than 10001 


‘es then set the status of Passenger to 





°@the length of <a string> 

= the name of this rule 

= the number of <term> 

°@the number of elements in <objects> 


| °@the price of <a passenger> 
*@the status of <a passenger> 








Rule sequence | Parameters 
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__38. Type Gold between double quotation marks. Move the cursor past the end quotation mark, and 
type a semi-colon (;). 





cal SOSSEMWel LELISIUT) SEPWILEWUIES cs 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 


















































if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 







- the price of Passenger is at least 75 and less than 10001 


then set the status of Passenger to "Gold"; 
a 








Rule sequence) Parameters | Additional Info 
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__ 39. The first rule is complete. It should look as follows. Press CTRL-S to save the rules so far. 
Then click on Add Rule to add the second (blank) rule into the editor. 


Fm —_ 
re *Passenger Decision Service.rules 2-3 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 


if all of the following conditions are true : 
- the customer name of Passenger contains "Jones" 


- the status of Passenger contains "Silver" 
- the price of Passenger is at least 7500 and less than 10001 


Chen set the status of Passenger to "Gold"; 








Rule sequence) Parameters | Additional Info 
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__40. The empty second rule is added to the editor. 


Re *Passenger_Decision_Service.rules 2-3 


Auther one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


2 ‘Rule 2' is empty. 


* Rule l 


if all of the following conditions are true : 

- the customer name of Passenger contains "Jones" 

—- the status of Passenger contains "Silver" 

- the price of Passenger is at least 7500 and less than 10001 
then set the status of Passenger to "Gold"; 


* Rule ? 


Rule sequence) Parameters | Additional Info 


__41. For the second rule, we will paste the rule into the editor. Open a Windows Explorer session. 
You can click on the icon in the Task Bar. 


3 
0 Windows Explorer 
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__42. Navigate to C:\student\DecisionService\Rules and open the Rule2.txt file with Notepad (you 
can double-click on the file name). 


OR SSS Sl OS StC<“— OD” 


Computer + Local Disk (C:) & student » DecisionService » Rules +4 


= - —— EE EE 






Organize ¥ || Open *¥ Print New folder 


ry student a Name : Date modified Type Size 
r AppsLibs 
|) Basic_Config 
) BPM 
|) BusinessRules 
: COBOL 
i COLL 
|. Data 
a )) Dp2LOG 
)) DBInput 
|). DBROUTE 
|) DecisionService 
a Data 
|) resources 


de Rules 





| Rulel 9/23/2013 4:07 PM Text Docurnent 1 KB 
i 9/23/2013 4:08 PM Text Document 





ml 


__43. Press CTRL-A to select the entire text, and then press CTRL-C to copy the selected text. 


Rule? -Notepad = = = _ 


— ee ___—™ 








1G 

1 customer mame of Passenger contains Jones 

PB status of Passenger contains “Silver” or the 
the price of Passenger 15 more than 10000 
5 of Passenger to " 















Status or Passenger 





CONTAINS 






Lab 4 — Decision service node Page 227 


IBM Software 


__44. Return to the Integration Bus Toolkit. Position your cursor at the start of Rule 2, and then press 
CTRL-V to paste the text into the editor. 


ee 


assenger_Decision_ Servicerules ci 


Author one or more rules that will make up your decision service. 
Press CTRL + SPACE to use content assist. 


* Rule l 





if all of the following conditions are true : 

- the customer name of Passenger contains "Jones" 

— the status of Passenger contains "Silver" 

- the price of Passenger is at least 7500 and less than 10001 
Chen set the status of Passenger to "Gold"; 





| 
! 
F the following conditions are true : 
— the customer name of Passenger contains "Jones" 
—- the status of Passenger contains "Silver" or the status of Passenger contains "Gold" 
—- the price of Passenger i138 more than 10000 
Then set the status of Passenger to "Platinum"; 





Rule sequence | Parameters | Additional Info 





__45. Press CTRL-S to save the rules. Close the rules editor. 


__ 46. Inthe Application Development explorer view, you will see the 
Passenger _Decision_Service.rules file you created, within a Decision Services folder. 


Application Development 
F Passenger 
4 (=. Schema Definitions 
4 £ (default namespace) 


ef Decision Services 


ce Passenger_Decision_Service.rules 
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4.4 Build the message flow 
You will now build the message flow that uses the rules that you just created. 


__1. Click on Passenger in the Application Development view to highlight it, then click the New... 
quick start link. Click on Message Flow from the New Artifact popup. 


Application De f4 te, Patterns Explo ~ Fi 
PbS” 





Application Development 





New Artifact 


c= Schema Definitions Message Flow 


fe (default namespace) 


[5] passenger.xsd Subflow 
@ Decision Services [=F Message Model... 


Ee Passenger Decision Service.rules [3 Message Ma 
— ee C] p 


ESOL File 


ce Decision Service 


__2. Ensure the Container is Passenger. Enter Status Decision as the Message flow name and 
click Finish. 


| (i New Message Flow 


Create a new message flow 


Select a container for the new message flow 


Container [Passenger Jp 


Message flow name: § Status Decision 
Flow organization 
Use default broker schema 


(default broker schema) 


Cancel 
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__3. Open the WebSphere MQ folder in the Palette, and drag a MQInput node onto the canvas. 
Name the node PASSENGER.IN. 





a 
S42] *Status Decision.msaflow ci “ 







<| <2 Palette 
Ae 
worites 
ie WebSphere MQ 4 
(|) MQInput 
ial] MQOutput 
i MQReply 
feta MOGet 
MOQHeader 


| » 








Mm 





|: MQOptimizedFlow... PASSENGER.IN 
ams JMS 

(a. HTTP 

Ly Web Services 

(ol SCA 

(gi: WebSphere Adapters 

> Routing 


(rv. .NET. bi 
Graph) User Defined Properties 


__4. — Inthe Properties for the MQInput node, on Basic tab, enter PASSENGER.IN as the Queue 
Name. 


fee *Status_Decision.msgflow so e = 








$2 Palette 
Rh & ; 
(2 Favorites 
e WebSphere MQ 2 
)2, MQInput 
(B) MQOutput 
(9 MQReply 
By MQGet | a 


i, MQHeader 
PASSENGER] 











mW" 


—| 





2 MQOptimizedFlow (D... — 
GmJMS 
(a. HTTP 

Web Services 

(0, SCA 

(gs WebSphere Adapters 

> Routing 


(n> «NET = 
Graph | User Defined Properties | 









































Eye [8 Problems = Outline | | Tasks | FA Deployment Log ©’ Progress View| <n Oo 
(2; MQ Input Node Properties - PASSENGER.IN 





“Queue name* Jf PASSENGERIN |) Browse MQ Services... 


Parser Options 
Advanced 
Validation 

















Note: Queue names are case sensitive. 
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Still in Properties, select the Input Message Parsing tab. Use the drop down on the Message 
domain box, and select XMLNSC as the parser. 





Properties £3 \ [2) Problems| 5= Outline) #] Tasks| FE Deployment Log) G’ Progress View ee So 


(=) MQ Input Node Properties - PASSENGER.IN 





> 


Basic 
Input Message Parsing | Message domain 


~ Parser Options 
Advanced 
Validation | Message 


| Message model 

















Physical format 





Now drag the Passenger_Decision_Service.rules file from the Application Development view 
right on to the message flow editor, and drop it after the PASSENGER.IN node. 














TES Application De 53 is Patterns Explo | = 6 || G2\*Status_Decision.msgflow £3 » 
8A &, “Ill 4. €® Palette 
Application Development New...|) [3 @ a = 
(2 Favorites 





Passenger 
CS. Schema Definitions 
f& (default namespace) 
[S) passenger.xsd 


(3 WebSphere MQ 


\2) MQInput 
i] MQOutput 









" 


G2 Flows (@ MQReply 

Status_Decision.msgflow i MQGet 
@® Decision Services ‘a, MQHeader : 

fe Passenger_Decision_Service.rules PASSENGER.IN 








2 MQOptimizedFlow (D... —~ 
(ims JMS 
(za, HTTP 
Lg Web Services 
GiSCA 
a WebSphere Adapters 

3 Routing 

(ab NET ~} 
|| Graph | User Defined Properties 

















This adds a Decision Service node to the message flow, and sets the properties to use the rules 
file you dragged and dropped. 


EL*Status. Decision.msgflow XN 
q &2 Palette 

(La Favorites 

| 4 WebSphere MQ = 
J) MQInput 

2] MQOutput 

ia? MQReply a | 
@, MQGet je 


a MQHeader 


- 


Mm 








PASSENGERJIN Decision Service 





J MQOptimizedFlow (D... 
| 

| ams JMS 

| Ca HTTP 

| Lag Web Services 

Lo) SCA 

(gh WebSphere Adapters 
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There is one property left to set. On the Basic tab of the Decision Service node Properties, click 
on the line within the Parameters box to highlight it. Then click the Edit... button. 


_ [£) Problems| G= Outline| 4) Tasks| FA Deployment Log|G Progress View 
+” Decision Service Node Properties - Decision Service 








ST Data location: A value must be set for this property. 
Description @ property 
Basic 


Use of this node is subject to specific licensing requirements, click here for details... 
Monitoring — 


Decision Service Name* _—— Passenger_Decision_Service.rules 





Ruleset* 


Browse... 
Passenger_Decision_Service + 
Parameters* 
@ 








Direction Verbalization Data location 











Use DecisionServiceRepository configurable service 


A pop-up Edit entry window appears. Click the Edit... button. 


(ik) Edit entry 


Data location* 


9 Data location: A value must be set for this property. 


(?) OK 
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__10. The XPath Express Builder window opens. Click the arrow twistie next to Data Types and then 
again on (x)= $Root. Click (Add Data Type...). 


Cr) XPath Expression Builder 


“Path Expression Builder 


Select the target from the Schema viewer, Function viewer or Operator viewer and drag and drop the nodes in the source 
viewer below. 











Data Types Viewer Path Functions Operators 
| Ly} String 
i Boolean 
aja Numeric 
L& NodeSet 
+ Le] Properties : Properties Type ao Axes 
> Le] JMSTransport : JMSTransport_type 
» 60- $Properties 
» ©) SLocalEnvironment 
(= $DestinationList 
(= SExceptionList 
» 60= SEnvironment 
a4 (Add Data Type...) 


("| Show XML Schema groups 
Path Expression 


+ Namespace settings 
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__11. Onthe Type Selection window that opens, select Passenger and click OK. 


Choose a type (? = any character, * = any string): 





Matching types: 


[e] Passenger 
(@] Price 
[e] Status 


Qualifier: 


«no target namespace> 
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‘(,) XPath Expression Builder 


“Path Expression Builder 


Select the target from the Schema viewer, Function viewer or Operator viewer and drag and drop the nodes in the source 


viewer below. 


IBM Software 


__12. Back on the XPath Expression Builder window, drag Passenger from the Data Types Viewer 
box down to the XPath Expression box. Click Finish. 











Data Types Viewer 


() Data Types 
(= $Root 
a (Add Data Type...) 
[€) Passenger [KMLNSC] 
MOMD : MQOMD_TYPE 
le] Wroperties : Properties Type 


("| Show XML S@hema groups 
Path Expression 
$Root/XMLNSC/Passenger 


+ Namespace settings 


Path Functions 
Ly} String 
i Boolean 
ret Numeric 
Le NodeSet 
aa Axes 


Operators 

















__13. The Data location in the Edit entry window should now be filled in with 


$Root/KMLNSC/Passenger. Click OK. 


Data location* 


$Root/XMLNSC/Passenger 


a 
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Finish 





Page 235 


IBM Software 


__14. The Data location on the Decision Service node Properties should now be filled in with 
$Root/KMLNSC/Passenger. 


15. 





(rare (2: Problems| G= Outline| #4) Tasks| FA Deployment Log | C Progress View. 


+” Decision Service Node Properties - Decision Service 





Ruleset* 


Parameters* 


al 


Name 








A decision service node executes a collection of business rules that use defined parameters. 


Use of this node is subject to specific licensing requirements, click here for details... 


Decision Service Name* _— Passenger_Decision_Service.rules 


Use DecisionServiceRepository configurable service 








Direction Verbalization 








Open the Routing folder in the Palette, and drag a Route node to the right of the Decision 
Service node. Press Enter to accept the default name. 





q &2 Palette 
bo 
2 Favorites 
(mg, WebSphere MQ 
ams JMS 
(zl HTTP 
Ls Web Services 
(ol SCA 
LG 


| » 


mM 






[j]) Publication 
ey Routel oLabel 
Me) Route 


AggregateControl 
AggregateReply 


El. i en epecun 


Graph | User Defined Properties 


-_ 
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PASSENGER.IN 
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__16. Right-click on the Route node and select Add Output Terminal. 


Be “Status Lh =CiSiOn.imsq low e5 "| 


q &2 Palette 


A & 


L2 Favorites 
(2 WebSphere MQ 7 


ams JMS 

(za HOOP 

L Web Services ‘“— —- ._ 
(ol SCA ae oa id c me| <) Undo Move 
|g WebSphere Adapters PASSENGERIN Decision Service ELs 

= Routing ae! Create Connection 
Ea baa + Create Cloned Node... 
Graph User Defined Properties ————T 


[= Properties x. ra Problems = Outline vz) Tasks | FE Deployment Log © Pr 


%, 
Nes 
am, 


Rename Output Terminal 


4h mew Be me 


__17. Enter Gold as the terminal name and click OK. 


Enter name of the new output terminal 











__18. Again right-click on the Route node and select Add Output Terminal. 


__19. This time, enter Platinum as the terminal name and click OK. 


Enter name of the new output terminal 


Faron] 








20. 





IBM Software 


Ctrl+7 
Ctrl+¥ 





3% Route Node Properties - Route 


@ Filter table: A value must be set for this property. 





Filter table Filter pattern Routing output terminal 
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21. 


On the Add Filter table entry window, use the drop down box for Routing output terminal and 
select Gold. Then click Edit... 


| (D) Add Filter table entry 


Filter pattern*™ 


Routing output terminal 


Match 


eT) (| a| 
Platinum 
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__ 22. The XPath Express Builder window opens. Click the arrow twisties for Data Types, (x)= $Root, 
and Passenger. Drag Status from the Data Types Viewer to the XPath Expression. 


I PxPath Expreseinn ney 


“Path Expression Builder 


Select the target from the Schema viewer, Function viewer or Operator viewer and drag and drop the nodes in the source 
viewer below. 








Nata Types Viewer Path Functions Operators 
L&) Data Types Ly} String 
, I= SRoot i Boolean 
gt (Add Data Type...) aja Numeric 
™ AAG Passenger [XMLNSC] CB NodeSet 


Ce Axes 


: Properties Type 
sport: JMSTransport_typ 


§$Root/XMLNSC/Passenger/Status 


+ Namespace settings 
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__ 23. Type =’Gold’ to complete the expression in the XPath Expression. Click Finish. 


| (i) APath Expression Builder 


“Path Expression Builder 


Select the target from the Schema viewer, Function viewer or Operator viewer and drag and drop the nodes in the source | ) 
viewer below, 


Data Types Viewer “Path Functions 
Data Types : Lay String 
(= SRoot J i Boolean 
a (Add Data Type...) aj Numeric 
Passenger [XMLNSC] Le NodeSet 
[€) CustomerName: string 7 a Axes 
Status : string 
Price: int 
MOMD : MOMD_TYPE 
Properties : Properties Type 
JMSTransport : JMSTransport_typ 
(= $Properties 


Operators 


("| Show XML Schema groups 
Path Expression 


SRoot/XMLNSC/Passenger/Statu 


+ Namespace settings 








__24. Ensure the Filter pattern reads $Root/KMLNSC/Passenger/Status=’Gold’ and the terminal is 
set to Gold, then click OK. 


(ir) Add Filter table entry ; 
Filter pattern 
$Root/XMLNSC/Passenger/Status='Gold' 


Routing output terminal 


Gold 
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__ 25. The routing filter is added to the Filter table in the Properties. Click Add... again. 


>| Properties £3 >» [£1 Problems| = Outline| 4) Tasks| FE Deployment Log. Pie el 


Filter table Filter pattern Routing output terminal 


$Root/XMLNSC/Passenger/Status='Gold' Gold Edit | 


Delete 


26. 


€ Filter pattern: A value must be set for this property. 
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27. 


Page 242 


Repeat step 22 and complete the expression in the XPath Expression to read 
$Root/KMLNSC/Passenger/Status=’Platinum’. Click Finish. 


| (P) XPath Expression Builder 


“Path Expression Builder 


Select the target from the Schema viewer, Function viewer or Operator viewer and drag and drop the nodes in the source 


viewer below, 


Data Types Viewer 
F Data Types 
4 @)= $Root 
gl (Add Data Type...) 
4 [e] Passenger [XMLNSC] 
[e¢] CustomerName: string 
[e] Status: string | 
(e| Price: int 
>» Le] MQOMD: MQMD_TYPE 
» [€] Properties : PropertiesType 
» [€] JMSTransport : JMSTransport_typ: 
» &)= $Properties 





("| Show XML Schema groups 
“Path Expression 


+ Namespace settings 





“Path Functions Operators 
Ly} String 
i Boolean 
ret Numeric 
Le NodeSet 
eae Axes 
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__28. Ensure the Filter pattern is $Root/KMLNSC/Passenger/Status=’Platinum’ and the terminal is 
set to Platinum. Click OK. 


(ik) Add Filter table entry 


Filter pattern 





$Root/XMLNSC/Passenger/Status='Platinum' 


Routing output terminal 


Platinum 





__29. The Route node Filter table entries are complete. 


| Properties x ‘fei Probie == Outline | £) Tasks) Fl Deployment Log a~ Oo | 


jeiieail Filter pattern Routing output terminal 


$Root/XMLNSC/Passenger/Status='Gold' Gold 
$Root/XMLNSC/Passenger/Status='Platinum’ Platinum 


Edit... 


Delete 





Lab 4 — Decision service node Page 243 


IBM Software 


__ 30. 


31. 
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Open the WebSphere MQ drawer in the Palette. Drag a MQOutput node to the message flow 
above and to the right of the Route node. Name the node PASSENGER.OUT. 


| El *Status_Decision.msgflow a 
“| 2 Palette 

[Ts \ : 

| Lat Favorites 
WebSphere MQ a | | 

I MOIn put . 

feu MOOutput 

‘Ge MQReply 


i MQGet = 
im) MQHeader J jeu 





L PASSENGERIN 
2 MQOptimizedFlow (D... 


Gin JMS 
(i HTTP 
| C3. Web Services 
|i sca 
| (gi: WebSphere Adapters 


( Rewstine. a: 
Graph | User Defined Properties 







PASSENGER.OUT| 


Decision Service Route 


On the MQOutput node Properties, on the Basic tab, set Queue name to PASSENGER.OUT 
(be sure you set Queue name and NOT Queue manager name). 


FE Properties £3 9* Hf! Problems| g= Outline Tasks | ES Deployment Log o Progress View 


cl] MQ Output Node Properties - PASSENGER.OUT 


Description 


Queue manager name 


Advanced 
Request 
Validation 


Queue name 


Monitoring 


NOTE: Queue names are case sensitive. 
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__ 32. Drag another MQOutput node to the message flow below PASSENGER.OUT, and name the 
node PASSENGER.GOLD. 


“Status_Decision.msgflow oN 
| &2 Palette 
by & 

2 Favorites 
ies WebSphere MQ ay __] 

(3, MQInput aif 

ia) MQOutput PASSENGER.OUT 

ia MQReply — ) 


ray MQHeader 


| » 


mM 











————— PASSENGER.IN Decision Service Route 
ii: MQOptimizedFlow (D... 

ams JMS 

La HTTP 

Ls Web Services 

(ol SCA 

(gi: WebSphere Adapters 


(4 Rowsrtine 
Graph | User Defined Properties 


r 





__ 33. In Properties, set the Queue name to PASSENGER.GOLD 


“= " rr Problems == Outline uz) Tasks EH] Deployment Log o Progress View 





cl] M 


Q Output Node Properties - PASSENGER.GOLD 


0 UEUE Manager hame 


Queue name 





Lab 4 — Decision service node Page 245 


IBM Software 


__ 34. Drag a third MQOutput node to the message flow under the other two MQOutput nodes. Name 


the node PASSENGER.PLATINUM. 


ee os 


<q &2 Palette 
A & 
2 Favorites 
ies WebSphere MQ a 
(2, MQInput 
ia) MQOutput 
ae MQReply 


|» 


m 











PASSENGERIN 


EE, MQGet | ii =" | ope 
ry MQHeader | = J 


ii: MQOptimizedFlow (D... 
ams JMS 

(a HTTP 

Ls Web Services 

(ol SCA 

(gi: WebSphere Adapters 


[4 Rewtine 
Graph | User Defined Properties 


= 


al 


PASSENGER.OUT 


(32) (ar 


PASSENGER.GOLD 











PASSENGER.PLATINU 


__35. In Properties, set the Queue name to PASSENGER.PLATINUM 


—| Properties 


ct] MQ Output Node Properties - PASSENGER.PLATINUM 


Description 


toh Eat Problems n= Qutline| 44) Tasks ES Deployment Log o Progress View| 








Basic Queue manager name 


Queue name 


Validation 





PASSENGER.PLATINUM |p 


g 





Monitoring 
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__ 36. Wire aconnector from the Out terminal of the PASSENGER.IN node to the In terminal of the 
Decision Service node. Wire a connector from the Out terminal of the Decision Service node 
to the In terminal of the Route node. 


fo 
=42| *Status Decision.msaflow 2: = 


q &2 Palette 





SV & a 

2 Favorites 

[> WebSphere MQ a — 
(|, MQInput q iaiP 
il] MQOutput 7 PASSENGER.OUT 
a MQReply —_ 
i, MQGet tel f 
lata SSENGER a = PASSENGER.GOLD 
m MQOptimizedFlow (D... PASSENGERIN Decision Service 

ams JMS — 

(Ga HOP aap 

L Web Services PASSENGER.PLATINUM 
lol SCA 

(gi: WebSphere Adapters 

[ Rewstinn id 


Graph | User Defined Properties 


Note: To create a connector wire, you can simply click directly on the source terminal, drag the 
wire, and click again on the target terminal. 


__ 37. Right-click the Route node and select Create Connection from the pop-up menu. 


ic 
=r! *Status Decision.m: gtlo Ny 


4 2 Palette 
Ry & “ 
_2& Favorites 
ied WebSphere MQ ee) __] 
1 Main af 
ia) MQOutput ! PASSENGER.OUT 
is MQReply ~| <I Undo Move Ctrl+Z 
= MQGet ja p———re «> “le Redo Ctrl+¥ 
iat, MQHeader | 


PASSENGERIN Decision Service 


m 











TEs MQOptimizedFlow (D... 


"Create Cloned Node... 
ams JMS ; 
Add Output Terminal 
La MALTE Remove Output Terminal 
idles Sendices Rename Output Terminal 
(oh SCA 
(gj: WebSphere Adapters of Cut Ctrl+X 
= Rowtina FE Copy Ctrl+C 
crph User Defined Properties] SSSS~S~S~S«~ ea Delete 
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38. 


39. 


Select the Default terminal from the list of terminals in the Terminal Selection window, and click 


OK. 


(i) Terminal Selection 


Filter terminal names (? = any character, * = any String): 








Select terminal: 


FP detaut | 








Drag the connector to the In terminal of the PASSENGER.OUT node. 


 &2 Palette 
Ry & < 
at Favorites 
ies WebSphere MQ ay 
(|) MQInput 
ial) MQOutput 
ie MQReply 
feta MOGet 
ry MQHeader 


m 


ii: MQOptimizedFlow (D... 
ims JMS 

(a HTTP 

Ls Web Services 

(ol SCA 

(gi: WebSphere Adapters 


[4 Rowstine oo 
Graph | User Defined Properties 
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al 


PASSENGER.OUT 






PASSENGERIN Decision Service PASSENGER.GOLD 
aap 
PASSENGER.PLATINUM 
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__40. Again right-click the Route node, select Create Connection, select the Gold terminal, and then 


At. 


click OK. 


(i Terminal Selection 


Filter terminal names (? = any character, * = any String): 








Select terminal: 


=> Failure 


= Platinum 
©& Default 








Drag the connector to the In terminal of the PASSENGER.GOLD node. 


q &2 Palette 
by & < 
La Favorites 
pe WebSphere MQ oe) 
(2, MQInput 
il] MQOutput 
ie MQReply 
feta MOGet 
ry MQHeader 


m 


ii: MQOptimizedFlow (D... 
ims JMS 

(a HTTP 

Ls Web Services 

(ol SCA 

(gi: WebSphere Adapters 


[4 Rowstine oo 
Graph | User Defined Properties 
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al 


PASSENGER.OUT 






a? —~f> —-(3.} ak 
PASSENGER.IN Decision Service PASSENGER.GOLD 
aap 
PASSENGER.PLATINUM 
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__42. Once more right-click the Route node, select Create Connection, select the Platinum terminal, 


and then click OK. 
| (it) Terminal Selection 


Filter terminal names (? = any character, * = any String): 


Select terminal 


= Failure 


© Default 


& Gold 





__43. Drag the connector to the In terminal of the PASSENGER.PLATINUM node. 


Fo =; 
EH] *Status Decision.msaflow 2 


 &2 Palette 

A & a 
at Favorites 
ies WebSphere MQ a) 
(=, MQInput 
i) MQOutput 
i MQReply 


mM 


ame |) (a§ Pe —@ 


———————— PASSENGER.IN 
ii: MQOptimizedFlow (D... 

ams JMS 

(4a HOOP 

L Web Services 

(ol SCA 

(gi: WebSphere Adapters 


(4 Routing x 
Graph | User Defined Properties 


al: 


PASSENGER.OUT 


al 








PASSENGER.GOLD 
‘aF 
PASSENGER.PLATINUM 


__44. The message flow is now complete. Save (CTRL-S) the message flow. 
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4.5 Test the Decision Service message flow 

You will now test the paths of the message flow, and see that the Decision Service node executes the 
business rules to evaluate the inputs and set the value of the status element if appropriate. The status 
element is then used to make the routing decision in the Route node. 


1. Right-click the PASSENGER.IN MQInput node and select Test... from the popup menu. 
































(ca status_Decision.msgflow xe 
‘| <2 Palette 

iby * 

| IG Favorites 

E 2 WebSphereMQ << 

Ih |e 

1, MQInput q Pid 

i] MQOutput 7 _/” PASSENGER.OUT 
8 MQReply _ ra 
Gh MQGet | ae | ae ee 
1D MQHeader en = 

| PASSET <) Undo Create Connection Ctrl+zZ PASSENGER.GOLD 
Oo MQOptimizedFlow (D... Redo Ctrl+¥ 
i = 

ams JMS Create Connection “ | 

ca HTTP Create Cloned Node... — 

iB Web Services UA SSENGER.PLATINUM 

—= of Cut Ctrl+X 
| &, 
Co Ctrl+C 
| Me WebSphere Adapters a 
Delete Delet 

| oS Rowting i | * an a — _ 
| Graph p22 2255 Properties = | oe ; 
(= Properties so eral =e = Outli Rotate 

2 MQ Input Node Properties - PA bela 
; | Promote Property... 

Description 

a aaa Add Breakpoints After Node 


Innit hAeccane Parcinn 


__2. — Click OK on the Confirm box. 


% The message flow ‘Status_Decision.msgflow’ is owned by an Application or a Library 
' and can not be deployed individually. The owning Application or Library will be 
deployed instead. Do you want to continue? 
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3. | When the Integrated Test Client opens, use the drop-down for Body and select Edit as text. 





(Ba Status Decision.msgflow | {E *P xe =e 
Events 


i Select the message flow you would like to test. Click Send Message to run. 


Message Flow Test Events > General Properties 


>al>SSl|BSaR ee 
[EF Invoke Message Flow Message flow: | /Passenger/Status_Decision.msgflow 
Input node: _PASSENGER.IN 
Message 


> Header 




















Edit as XML structure 


Import from external file 


























4. Click Import Source... 





(GE Status Decision.msgflow _| [E] *Passenger.r xe =6 
Events 


i Select the message flow you would like to test. Click Send Message to run. 


Message Flow Test Events > General Properties 


>ale se Fl (BER EE 
[EF Invoke Message Flow Message flow: iA Passenger/Status_Decision.msgflow 
Input node: _PASSENGER.IN 
Message 


> Header 















































Events Configuration 
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5. Change to the C:\student\DecisionService\Data directory 


click Open. 


(i) Open 


-_ rie ee 


GOW- r « student + DecisionService + Data 





Organize ¥ New folder 
Name 


Ml Desktop 


Ip Downloads passengerl 


all Recent Places = passenger2 


Libraries 


[Eel Documents 
al’ Music 

=| Pictures 
ee Videos 


( Computer 
&, Local Disk (C:) 
G2 Shared Folders (\ + 4 | 


File name: passenger 
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Date modified 

0/24/2013 10:06 AM 
8/20/2013 11:73 AM 
6/20/2013 12:17 PM 





IBM Software 


. Select the passenger.txt file and 


Text Document 
Text Document 
Text Document 
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__6. _ The test file is loaded and displayed. Click Send Message. 


Status_Decision.msgflow 


Events 


1 Select the message flow you would like to test. Click Send Message to run. 


Message Flow Test Events + General Properties 


ae a 


EY Invoke Message Flow Message flow: |/Passenger/Status_Decision.msgflow 


Input node: PASSENGER.IN 
Message 


* Header 


© <Passengero| 
<CustomerName>Jones</CustomerName> 
<Status>Silver</Status> 
<Price>5000</Price> 
</ Passenger> 


Events | Configuration 





_7. 
opecify deployment details 
This server instance is currently running. 
Deployment location: 
4 [el Integration Bus v9.0 New Local Integration Node ... 
4 <4] IBSNODE 
7, default Connect to Remote Integration Node... 
Trace and debug 
|_| Stop at the beginning of the flow during debugging 
Always use the same deployment location for every test run 
_<Bock | Nets PL Finish) 
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__8. Set the Seconds to wait for deployment completion to 90 and click Finish. 


(i Select Deployment Location 


opecify Test Settings 
Determine the settings of the test environment. 











Seconds to wart for deployment completion 


Seconds to wart after Test Client complete the deployment 

Seconds to wart on launching the debugger for tracing purpose 20 

("| Show information dialog before disconnecting debugger. 

Seconds to wait for test client to stop 120 

(| Create queues of input and output nodes of message flows when host name is localhost 
("| Add or modify (but not clear) what has already been deployed on the execution group 
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9. The Passenger Application is packaged into a BAR file (created and stored in Independent 
Resources—TestClientBarFiles) and then deployed to the default Integration Server. The test 
message is then sent to the PASSENGER.IN MQInput node, which is then processed by the 
Status Decision message flow. You see the message sent to PASSENGER.IN in the test 
Events, and then you see the Event when the message is sent to one of the three MQOutput 
nodes. Which MQOutput node the message is sent to depends on the decision made and 
message Status element being updated. 


For this test, the message is routed to the PASSENGER.OUT MQOutput node; therefore, the 
business rules that were executed did not alter the Status, as no rules matched, and the Route 
node sent the message to the default terminal, which is wired to PASSENGER.OUT. 





EH] Status_Decision.msgflow *Passenger.mbtest °-) ~O 
Events 
Message Flow Test Events » General Properties 
> Pl aer ~ Detailed Properties 
EF Invoke Message Flow Host: localhost 
v Message flows deployment successfully completed 
Pp Starting Port: 0 
@ Sending Message to MO Queue "PASSENGER.IN" Server channel: SYSTEM.BKR.CONFIG 


MQ Queue Monitor "PASSENGER.OUT" 


El}, Stopped listening for response 





Queue manager: IB9QMGR 








Stopped Queue: PASSENGER.OUT 
Message 
> Header 
Body: | View as XML structure x. 
Name Value 


4 Passenger 


CustomerName Jones 
Status Silver 
Price 5000 





Events Configuration 
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__10. Right-click on the Invoke Message Flow event, and select Duplicate from the pop-up menu. 


Status_Decision.msgflow 


Events 
Message Flow Test Events 


Message flow: |/Passenger/Status_Decision.msgflow 
wf Message flows deplo 
4a \p Starting 
i Sending Messagq uplica’ 
a2 MQ Queue Moni » Header 
[Ej|, Stopped listening Body | View as source 
lM) Stopped 


Input node: PASSEMGER.IN 


Message 


Show in hexadecimal viewer (Read Only) 


Remove All 
«Passenger= 


<CustomerName>Jones</CustomerName> 
<Status> Silver</Status> 

<Price> 5000</Price> 

«/Passenger> 


Show flow wiew 


| Irmport Source... | | Send Message | 


Configuration 





__11. With the new (second) Invoke Message Flow event highlighted, click Import Source.... 


Lab 4 — Decision service node 


Status_Decision.msgflow 
Events 


1 Select the message flow you would like to test. Click Send Message to run. 


Message Flow Test Events + General Properties 


rPae|>SF|/BOR ~ Detailed Properties 
F [EY Invoke Message Flow Message flow: /Passenger/Status_Decision.msgflow + 


vw Message flows deployment successfully completed — or PASSENGER.IN = 
4a Vp Starting M 
lessage 
a Sending Message to MQ Queue "PASSENGERIN" 
@ MQ Queue Monitor "PASSENGER.OUT" » Header 


Body 


© <Passenger> 
<CustomerName>Jones</CustomerName> 
<Status>Silver</Status> 
<Price>5000</Price> 
</Passenger> 


Events | Configuration 
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__12. Select the passengert1.txt file, and click Open. 














Sr Favorites | Date modified 


Ml Desktop _ | passenge 9/24/2013 10:06 AM = Text Document 


ig. Downloads Ppassengerl | 8/20/2013 11:23 AM Text Document 


“S) Recent Places 





Bf20/2013 12:17 PM Text Document 


Libraries 
[Eel Documents 
al) Music 
=| Pictures 
Ae Videos 


ie! Computer 
& Local Disk (C:) 
Ge Shared Folders (7 








Filename: passengerl 























Events 
1 Select the message flow you would like to test. Click Send Message to run. 
Message Flow Test Events - General Properties 
rales S| BOF a 
a [EY Invoke Message Flow Message flow: /Passenger/Status_Decision.msgflaw 
vw Message flows deployment successfully completed — a PASSENGER.IN os 
4a Vp Starting 
ie Sending Message to MQ Queue "PASSENGERIN" 7 
#2 MQ Queue Monitor "PASSENGER.OUT" aac 
Stopped 
[EY Invoke Message Flow <Passenger> 
<CustomerName>Jones</CustomerName> 
<Status>Silver</Status> 
<Price>10000</Price> 
</Passenger> 
Events | Configuration 
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__ 14. This time, we see the message sent to the PASSENGER.GOLD MQOutput node in the events, 
and we can see that Status of the message was changed to Gold. This was done by the 
successful evaulation of Rule 1 in our Decision Service node. 


Status_Decision.msgflow 


Events 


Message Flow Test Events 


ama 
F [EY Invoke Message Flow 
vw Message flows deployment successfully completed 
4a Vp Starting 


fa Sending Message to MQ Queue "PASSENGERIN" 


@ MQ Queue Monitor "PASSENGER.OUT" 
[E}\, Stopped listening for response 
Stopped 
a (EF Invoke Message Flow 
wv Message flows deployment successfully completed 
4a \p Starting 
Sending 


Stopped 


localhost 
0 
Server channel:  SYSTEM.BER.CONFIG 
Queue manager; IBSQMGR 
Queue: PASSENGER.GOLD 
Message 
* Header 
Body: | View as AML structure 
Name 


Passenger 
CustomerName 





__15. Right-click on either Invoke Message Flow event, and select Duplicate again. 


Status_Decision.msgflow 


Events 


Message Flow Test Events 


am ay 
F [EY Invoke Message Flow 
wv Message flows deployment successfully completed 
4 Vp Starting 


7 Sending Message to MQ Queue "PASSENGERIN" 


a MQ Queue Monitor "PASSENGER.OUT" 
[E}j, Stopped listening for response 
Stopped 
' Invoke Message Flo 
wv” Message flows c 
Vp Starting 
@ Sending Mes 
a? MQ Queue 
[E)\, Stopped liste 
Stopped Remove 





~~ Rename 
Remove All 


Show flow view 


Events | Configuration 
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Message flow: | 
Input node; | PASSENGER.IN 
Message 


* Header 


=<Passenger> 


<CustomerName>Jones< /CustomerName> 
<Status>Silver</Statug> 


<Price>10000</Price> 
</Passenger> 
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__16. With the new (third) Invoke Message Flow event highlighted, click Import Source.... 
__17. Select the passenger2.txt file and click Open. 

Ur) Open 

) 4 az mM « student + DecisionService + Data 7 |r) search Data 


Organize ¥ New folder 












































wv Favorites pre Name Date modified 


BE Desktop _| passenger 9/24/2013 10:06 AM Text Document 
Jg Downloads passengerl 8/20/2013 11:23 AM = Text Document 


©] Recent Places | passenger2 8/20/2013 12:17 PM 


Text Docurment 


Libraries 
[Eel Documents 
al’ Music 
(=| Pictures 
ee Videos 


ie! Computer 
£ Local Disk (C:) 
Coil Shrareccl Fooicers (7 |p IID 
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__ 18. The test file is loaded. Notice the Status in the test message is Silver. Click Send Message. 


Status_Decision.msgflow 


Events 


1 Select the message flow you would like to test. Click Send Message to run. 


Message Flow Test Events - General Properties 


rele Ol BO sical ck 
= [EY Invoke Message Flow _ ; 7 
vv Message flows deployment successfully completed ee oe | PASSENGER IN = 
a \% Starting M 
lessage 
ie Sending Message to MQ Queue "PASSENGERIN" 7 
@ MQ Queue Monitor "PASSENGER.OUT" » Header 
Stopped 
a (EF Invoke Message Flow 


wv Message flows deployment successfully completed <CustomerName>Jones</CustomerName> 
4 \p Starting <Status>Silver</5tatus> 
@ Sending Message to MQ Queue "PASSENGERIN" <Price>10001</Price> 
a2 MQ Queue Monitor "PASSENGER.GOLD" </Passenger> 
[E)\, Stopped listening for response 
Stopped 
[EF Invoke Message Flow 


Message flow: | /Passenger/Status_Decision.msgflow 

















<Passenger> 


Events | Configuration 





__19. This time, we see the message sent to the PASSENGER.PLATINUM MQoOutput node in the 


events, and we can see that Status of the message was changed to Platinum. This was done 
by the successful evaulation of Rule 2 in our Decision Service node. 





fe: Status_Decision.msgflow | E| *Pass smbtest 3 


Events 


Message Flow Test Events 


ry e|\> eS Bar 
a [EF Invoke Message Flow 
v Message flows deployment successfully completed 
4 }p Starting =ort 0 
4 Sending Message to MQ Queue "PASSENGER.IN" 
a MQ Queue Monitor "PASSENGER.OUT" 
E)\, Stopped listening for response ee ee ee 
@ Stopped Queue: PASSENGER.PLATINUM 
4 [EF Invoke Message Flow Message 


A Message flows deployment successfully completed 5 Pica 
4 > Starting 


a MQ Queue Monitor "PASSENGER.GOLD" l ; 7 
E}\, Stopped listening for response Name 
@ Stopped Passenger 
a {EF Invoke Message Flow slau 


v Message flows deployment successfully completed 
4 Vp Starting 








Server channel: | SYSTEM.BKR.CONFIG 




















El}, Stopped listening for response 
@ Stopped 














Events | Configuration 
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__ 20. Save the test file (CTRL-S), allowing all three tests to be saved for testing again. Select the 
Passenger folder, and click Finish. 
(i Save Execution Trace 


save Execution Trace 
Save the execution trace and all test configurations of 
Passenger.mbtest in a file. 

Enter or select the parent folder: 


Passenger 


> Passenger 
[— TestClientBarFiles 


File name: Passenger.mbtest 


Finish Cancel 





CONGRATULATIONS! 


This concludes the Decision Service node lab. 


This is the end of Lab 4. 
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Lab 5 Service discovery for database and MQ Services 


5.1 Introduction to database and MQ Services 


IBM Integration Bus V9.0 provides a new service discovery feature for MQ and database resources. 
Discovered services are used at development time to create Integration Bus Toolkit MQ and database 
artifacts. These artifacts are then used to create applications. The MQ and database artifacts are then 
deployed to the Integration Bus runtime environment. 


MQ Services can be optionally stored in an Integration Registry component which runs on an Integration 
Node. MQ Services stored in this way can be imported by other Integration Bus developers. 


This lab guide will demonstrate: 


How to create a Request-Response MQ Service 

How to store MQ services in an Integration Registry 

How to import previously stored MQ services into a developer's workspace 

How to create a database service (note: database services cannot currently be stored in the 

Integration Registry) 

e How to extend an existing database service by adding additional operations 

e How to use these services at development time to create Integration Bus MQ and database 
artifacts 

e How to use the Integration Bus artifacts to create and extend applications 


5.2 Lab preparation 


5.2.1 Priming the Integration Service Registry 


1. ‘If not open, start the IBM Integration Bus Toolkit by double-clicking its desktop icon. Enter 
c:\Student\service_discovery\workspace as the workspace and select OK. 


Select a workspace 


IBM Integration Toolkit stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


Workspace: § C:\student\service_discovery\workspace J 





| Use this as the default and do not ask again 











[Cancel 
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lf already open, select File>Switch Workspace Other... to get the workspace selection 
dialog, and then enter (or use Browse) c:\Student\service_discovery\workspace as the 
workspace and select OK. 


2. Click the X to close the Welcome screen. 


= Welcome" } | 


IBM Integration 


3. The required MQ Service is available in a Project Interchange (PI) file in 
c:\student\service_discovery\install\PrimeServiceRegistry.zip. Import this PI file into the 
Integration Toolkit. 


Select File—Import... from the menu. 








Navigate Search Project Run Windc 
New Alt+Shift+N > 


Save All Ctri+Shift+5 


2) Refresh F5 


Convert Line Delimiters To > 
Print... 


Switch Workspace > 
Restart 
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4. Click the twistie arrow for the Other folder, select Project Interchange, and click Next. 


| Select 
Import a project and its dependent projects from a Zip file. 


Select an import source: 
type filter text 











» (> Modeling 

> © Plug-in Development 
> (& Profiling 

D Run/Debug 

> > Team 

> & Test 

> => Web 

>» & Web services 
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5. Click Browse... on the Import Project Interchange Contents window. 


= rN ai lee cam | 





Import Projects from a zip file. 


From zip file: 


Project location root: C:\student\Service_discovery\workspace 
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6. Change to the c:\student\service_discovery\install directory, and select the 
PrimeServiceRegistry file. Click Open. 





Organize ¥ New folder 


Sr Favorites Date modified 
HE Desktop 7/18/2013 8:53 AM ‘File folder 
Jp Downloads i 7/18/2013 8:54 AM File folder 
“L| Recent Places | 7) PrimeServiceRegistry 1/18/2013 8:53AM  ¢ 





_@ Libraries 
«| Documents 
a) Music 
Pictures 
#& Videos 





* Computer 
&, Local Disk (C:) 
G9 Shared Folders (\~ ¢ 


Filename: PrimeServiceRegistry 
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| Import Projects 
Import Projects from a zip file. 


From zip file: 


Project location root: C:\student\Service_discovery\workspace 
iv] iS} PrimeServiceRegistry 


el 




















| Select All| | Deselect All| | Select Referenced | 


> BA PrimeServiceRegistry 
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C:\student\Service_discovery\install\PrimeServiceReg ~ 


7. Ensure the box is checked next to PrimeServiceRegistry then click Finish. 


eStore) 


7 
—- 
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__9. Expand the Library until you see the MQ Service MQS_retrieveEmployeeRR.service. Right- 
click on this service definition and select Publish to Registry... from the menu. 


=, 


», 22, Patterns Explo | =" {ms 




















Quick 
Start bul 
EA PrimeServiceRegistry 

> ES Schema Definitions Star 
An Ap 

New > 

Open 
Open With 


Copy 
Paste 
Delete 
Move... 


Rename... 


Add Bookmark... 








& Integ ration N 3 \ 8 Data Source | Import. 


Export... 





dea Integration Nodes 


Al IB9NODE Bere 
& default a Generate Documentation... 


10. Select the IB9Node and click Finish. 





Publish To Registry 
Select the integration node that contains the Integration Registry to which you want to publish your Service 
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__11. After a few seconds the Integration Registry view will open automatically, and the MQ service is 
stored in the Services folder. 
[=] Properties '{£) Problems | B= Outline |Z) Tasks | EE Deployment Log}Pr. 


————— 


| « ae Integration Registries 
4 & Integration Registry on IBINODE 





__12. Now delete the PrimeServiceRegistry library. Right-click on the PrimeServiceRegistry Library 
and select Delete. 







New 


Manage Library references 









Manage included projects 





Focus on Library 


Convert to Application 


Export XSDs from Library 













4 Bh PrimeServiceRegistry 
» (S Schema Definitio Migrate 
4 (> Services 


> sll) MQS_retrieve ede 


| Also delete contents under "C:\student\Service_discovery\workspace\PrimeServiceRegistry” 
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5.2.2 Building the SAMPLE connection 


The database connection for SAMPLE already exists. We will connect to it So we can use tt. 


__1. Click on the Data Source Explorer view to open tt. 





- r 
> INtTEqration Wwodes 


See 


es FE Data Source ExplorerJes § ~ © 


iS ou Integration Nodes — 
4 & IBONODE 
> & default 





__2. _ Right-click the SAMPLE Database Connection, and select Connect from the menu. 


a i 








Disconnect 
Ping... 

Work Offline 
Save Offline 


Rename 
Delete 
Duplicate 


Open SQL Scrapbook 
$5 Create EJBs from Tables (1.x-2.x) 


te Integration Nodes | 











| Start Simulation 
4 (& Database Connections 
4 BIRT Classic Model 
3 CNTRYDB [082 Alli 
£3 CUSTDB (DB? Alias Run in New Workbench... 
NEWEMPDB [DB2 J Package... 
SAMPLE [DB2 Alias]] 


Stop Simulation 









Edit and Arrange Palette ... 











sf ODA Data Sources 
t= Classic Models Inc. Sample Database 
(=> Flat File Data Source 

L= JDBC Data Source 

(= Web Services Data Source 

(= XML Data Source 
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F2 
Delete 


Properties Alt+ Enter 







Curr 


Con 


Page 271 


__3. Set the User name to db2admin and Password to db8admin. Also click the Save password 
checkbox. Click OK. 


(2) Properties for SAMPLE 


type filter text Driver Properties 
Common | 
Default Schema Filter Drivers: | IBM Data Server Driver for JDBC and SQU Default 
Default Stored Procedure F 5 . 
Default Table Filter roperues 


Driver Properties General Optional! 


Version Database: SAMPLE 








Host: localhost 
Port number: 50000 

User name: 
Password: 

IY! Save 

Default schema: 


Connection URL: jdbe:db2://localhost:50000/SAMPLE:retrieveMes + 
sagesFromServerOnGetMessage=true; 


Test Connection | 











__4. A JDBC connection will be established to the SAMPLE database, and you will see the SAMPLE 
database with a blue “connected” database icon. 


ae Integration Nodes i © Data Source Explorer ° > 
= % 2 (5) +! od! B 
4 (& Database Connections 


4 BIRT Classic Models Sample Database 

Es CNTRYDB [DB2 Alias) 

E39 CUSTDB (DB? Alias) 

3s NEWEMPDB [DB2 Alias] 
Nagpal (DB2 for Linux, UNIX, and Windows V9.7) | 

-» @ SAMPLE 


2 EXDIOre 















































4 (= ODA Data Sources 
t= Classic Models Inc. Sample Database 
(=, Flat File Data Source 
> JDBC Data Source 
(= Web Services Data Source 
i Fi Lis a 





We can now build our database definition file. 
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5. Create a new library to hold the service definitions. 


In the Application Development explorer, click New Library.... 


2 _ Sc, Patterns Explo =o 





New Application... 


| New Integration Service... 
Nevttey} 


6. Name the library serviceDefinitions and click Finish. 


Create a new library 


A library allows re-usable artifacts to be grouped and managed together. Enter a 
name for the new library. 


Library name} serviceDefinitions | 
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_ as In the serviceDefinitions library, click New, and select Database Definition. 


Ls Application De 53 8 Patterns Explo Sim 
Seg” 


| ‘Application — New... 











Create a new artifact. 





ji) Message Flov 

2 Subflow 

= | sage Model... 
fe Message Map 
GE ESOL File 

CF Decision Service 

‘ii MOQ Service 

sj Database Service 

f& Broker Schema 

@i] Adapter Connection 

0 Database Definition | 
= Data Lir neage Documents 

(ij BAR file 

Eg Integration Bus Test Client 























2 Intenra eS Naf, 
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_ 8. 


_ 9. 


Since we do not have an existing project to store this, click New to create a new database 
design project. Name this SAMPLE. 


-@ New Database Definition File 


Create a database definition file 
Specify the database type, version and the data design project that will contain the database definition file. 


Database: DB2 for Linux, UNIX, and Windows + 
<— | @ New Data Design Project 


Create a data design project 
Specify a basic definition for the new project. This project stores data design objects. 


Use default location 
Browse... 





Working sets 
Add project to working sets 











Working sets: 





Data Sources 
Jassic Models Inc. Sample Database 


ier Ela Pi des, Cases 





























Te a oer 


Click Finish. 
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__10. The Database Design project field has now been populated with the SAMPLE project. Select 
V9.7 from the Version drop-down box. 








—— - = — a —— Fj —— 
a 
| Create a database definition file 

| 
4 


Specify the database type, version and the data design project that will contain the database definition file. 


Data design project: | 


(SAMPLE +] (Newn. 
Database: 


Version: 











Finish 


_11. Click Next. 
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__12. Highlight the SAMPLE connection that we have connected to and click Next. 





~ Properties 
Property Value 
Name SAMPLE 
Description 
Category Database Connections 
Database SAMPLE 
JDBC Driver Class com.ibm.db2.jcc.DB2Driver 
Class Location: C gan ca or tal ibm. Catal. <i 





Finish 


__ 13. 





project connects to the same database. 
Click "Yes" to confirm overwriting this file, or click "No" and choose a 
connection to a different database. 


| gn » The existing database definition file "SAMPLE.dbm” in the data design 
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__14. Select the ADMIN schema (the SAMPLE database was created under the ADMIN schema). 
Click Finish. 


© New Database Definition File 


Select Schema 


Select schema(s) to reverse engineer. 


Apply name filter (? = Any character, * = Any string): 











© SYSCAT 
™ SYSFUN 

™ SYSIBM 
SYSIBMADM 

™ SYSIBMINTERNAL 
SYSIBMTS 
SYSPROC 
SYSPUBLIC 
SYSSTAT 














BA serviceDefinitions 
LY (New...) 

(@) Independent Resources 
i SAMPLE 
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__16. Right-click on the SAMPLE Database Design project, and select Add project to existing 
container from the menu. 





ation Deve sis 


File Edit Navigat 












Migrate 
| Go Into 
) BA serviceDefin 
7? (New...) | Copy 
Independen Paste 
> le SAMPLE Delete 
| Move... 


__17. Click on the serviceDefinitions library, and then click OK. 


Select an Application, Library, or Integration Service into which the project will be included. 
The project will remain on the workspace. 








The following projects will also be included as they are 
referenced by the checked projects. 
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__18. The Database Definition file will now be in the serviceDefinitions library. It is now available to the 
application and does not need to be changed further. If it is open, close the SAMPLE.dbm 
editor. 


Fy) Application Dey £3», °c, Patterns Explore) ~ O 
A 4 


Se & = 
Application Development New... 
4 BA serviceDefinitions: 
a ae ee 
4 loa SAMPLE 
“fm SAMPLE.dbm 


5.2.3 Adding a schema and creating MQ queues 


__1. Start Windows Explorer if not already running, by clicking on the Windows Explorer icon in the 
task bar. 
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2. In Windows Explorer, navigate to C:\student\Service_discovery\resources and drag the 
Employee.xsd file on to the Integration Bus Toolkit and drop the file on to the 
serviceDefinitions Library. 








Integr 
File Ect Navigate Search Popect Fun Window Help 
Fa Application De cs 2, Patterns Explo 
Application Development New... —— | - a= 22 
GuU- J) * Local Disk (C:) > student » Serice_discovery » resources > 
pe sericeDefinitions 
Other Resources Organize ¥ i] Open = New folder 
beads KlessageModelin = h ‘ Jate | j T 
an Late modified {pe 
$f) SAMPLE.dbm de 9 9 ne ate mo-difie pe 
& MersageSight 
" e _| addEmployedengl 
a addEmployee_Compute.esq! fat: 
~~ addEmployee_ImplementhiQS Compute... 7/18/2013 8:54 4M Text Document 
J M7 2 
" : _| addEmployeel W_Compute.esql 18/2 
ne addEmployee2W_Compute.esq| 
7 MOTT sample : 
att )) DBDemo_Ins_Upd_Ret_del_Pl 
pattern - AG 
J) PattemAuth ae 
PHP 4 i a} la i LES ie 2 uve i ' 
- _)) ManageEmployee_Stagel Read TIS SS ART Compressed (zipp 
5 
E )) ManageEmployee_Stage2?_Read_Add F/18/2013 8 { 3 
). RecordReplay 
|, ManageEmployeeTests 
i SAPFiles = 
: J) SecuR | reedimpleyeeceg! 
Yo Integra # Data So to. Data Pr ot ama i] | | " a RetrieveEmployee.mbtest 
e 
=, - ae retrieveEmployee_ImplementMQ5_Com... 
a Senice_creation : Bi Arenas ee ‘ ' 
jo: SAMPLE Bh sevice dsc _]y RetrieveEimployeeFlows 1/18/2013 8:54 AM = Compressed (zips 
rice_discove 
sd : < iy SAMPLE 18/2013 £:54 4M Sompressed (Zipp 
ata 
TestAddManageEmployee.mbtest 18/2013 6:54 AM = ©MBTEST File 
). install 
). resources 
a Workspace - 4 it i 
Employee Date modified: 7/18/2013 &:54 AM Date created: 6/15/2013 9:51 PM 
ee eee XML Schema File Size: 1014 bytes 


"° [2 | serviceDefinitions ————— — = = 


The schema will be shown in the serviceDefinitions project. We will use this when creating the 
MQ Service definitions to define the message types used by the MQ service. 


coe 





= eS < 
— i 


. P ce a . SS 
(ippplication Dele, Patterns Explo | © C1 
| = 
_ Application Development N ul 


4 BA serviceDefinitions 
4 ( Schema Definitions 
a & http://www.serviceDisco.com/Employee 
ee (S) Employee.xsd 
4a > Other Resources 
ie SAMPLE 





3. We now need to create the MQ queues used by the lab. There is a masc script file available to 
create the queues. Open a Command Prompt by clicking on the Command Prompt icon in the 
task bar. 
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__4. — Inthe Command Prompt, enter cd\student\service_discovery\install\mqsetup 








a =e | | fo] x 
Administrator: Command Prompt io =e 


Microsoft Windows [Version 6.1.7681 ] 
Copyright <c> 286609 Microsoft Corporation. All rights reserved. 


-cdNstudent \service_discoverysinstall\mgsetup — 


c= \student\Service_discoverysinstall\MQSetup> 





__5. — Inthe Command Prompt, enter ruanmgsc IB9QMGR < service_discovery.mqsc 


Administrator: Command Prompt LS | © Si 


Microsoft Windows (Version 6.1.7681 ] 
Copyright ¢c> 2669 Microsoft Corporation. All rights reserved. 


c=\>cd\student\service_discoverysinstall\mqsetup 


ent\Service_discoverysinstall\MQSetuperunmgsc IBYQMGR < service_discovery 
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__6. — The script will execute, and you should see that there were no errors. 











Administrator: Command Prompt 


4 =: DEFINE Q@LCSERVICE.DISCOUERY .DB.ADD.OUT> 
D> BOTHRESH<@> USAGECNORMAL) REPLACE 
ANG8H06: WebSphere MQ queue created. 


DEFINE QLCSERVICE.TEST> PUTCENABLED> GETCENABLED> BOTHRESHC@> USAGECNOR 


1Q queue crea 
: DEFINE QL<SERUICE. TEST. RETRIEVED PUT<CENABLED> GETCENABLED> BOTHRESH¢@> 
WUSAGECNORMAL> REPLACE 
ANQ8HH6: WebSphere MQ queue created. 


?* = DEFINE Q@LCSERVICE.DISCOUERY .DB.DELETE.IND> PUTCENABLED> GETCENA 
BLED> BOTHRESH¢C6> USAGECNORMAL> REPLACE 
AMNQ8HH6: WebSphere MQ queue created. 

8 : DEFINE QLCSERUICE.DISCOVERY .DB.DELETE.OUT> PUTCENABLED> GETCENA 
BLED> BOTHRESH¢C@> USAGECNORMAL> REPLACE 
AMNG8HH6: WebSphere MQ queue created. 


ifs NQ@SC commands read. 
No commands have a syntax error. 
All valid M@SC commands were processed. 


c=\student\Service_discoveryNinstall MQ@setup> 





__7. — Inthe Command Prompt, enter exit to close the window. 


Gas Administrator: Command Prompt _o | © So 
4 =: DEFINE Q@LCSERVICE.DISCOUVERY .DB.ADD.OUT> PUT<ENABLED> GET<ENABLE] 

D> BOTHRESHC@> USAGECNORMAL) REPLACE 

AMNQSHGH6: WebSphere MQ queue created. 


DEFINE QLCSERVICE.TEST> PUTCENABLED> GETCENABLED> BOTHRESH<@)> USAGECNOR 


: DEFINE QL<SERUICE. TEST . RETRIEVE PUT<ENABLED> GET¢ENABLED> BOTHRESH<¢@> 

USAGECNORMAL>) REPLACE 
ANQG8HH6: WebSphere MQ queue created. 

? = DEFINE GLCSERVICE.DISCOVERY .DB. DELETE.IWND> PUTCENABLED> GETCENA 
BLED> BOTHRESHC8> USAGECNORMAL> REPLACE 
AMQ8HH6: WebSphere MQ queue created. 

8 : DEFINE QLCSERVICE. DISCOVERY .DB.DELETE.OUT> PUTCENABLED> GET<CENA 
BLED> BOTHRESH¢@> USAGECNORMAL> REPLACE 
ANG8HH6: WebSphere MQ queue created. 


8 MQSC commands read. 
No commands have a syntax error. 
All valid MQSC commands were processed. 


c=\student\Service_discoveryNinstall\M@Setuy > 





5.3. MQ Services 


5.3.1. Background 


Think of an MQ Service as an MQ application that provides information via one or more MQ resources. 
For the purposes of this lab guide, you will create a “Request-Response” MQ service that will be used to 
develop an application called ManageEmployee. The application will also use a discovered database 
service to manage and retrieve data in a database. 
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Once discovered, MQ services can be stored in the Integration Registry component allowing other 
developers to develop applications using the discovered services. You will also import an MQ Service 
that has been developed by another Integration Bus developer and use this service to extend the 
ManageEmployee application. 


5.3.2 Create a MQ request response service definition 


The following sections will guide you through creating MQ Service definitions for Queues that will be 
used later in this lab guide. 


__1. Right-click on the serviceDefinitions Library and choose New—>MQ Service. 
















t ration yn b! (E10 
=a oe New >| mf} Message Flow 
File Edit Navigate Si eT bf 
7 = Manage Library references sted Seman 
ee SS. Manage included projects Ef Message Model .. 
a | [— Ma: 
Application De 3 N “ : e te} Message Map 
| \ | £ Convert to Application Broker Schema 
Application Develop 
|| Export XSDs from Library ® Adapter Connection 
|| 4 \BA serviceDefinitions {) Database Definition 
S. Schema Defi Migrate - 
oe ee | : 2% Data Lineage Documents 
4 €& http://ww cous a 
[S) Empleo’ (i BAR file 
4 \* Other Resourc Copy Ex; Integration Bus Test Client 
> lay SAMPLE Paste uf _ Decision Service 
Delete a 
Yea, £j Database Service 
Rename... [Al Application 
Sy Import... [5] Integration Service 
ey «Export... BA Library 
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2. Inthe Create New MQ Service window, set the Service Name to MQS_addEmployeeRR and 
click Finish. 


Create New MQ Service 


Create a new Service by discovering resources from WebSphere MQ. Specify 
the Service name and the library that stores the Service artifacts 
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3. The MQ Service creation editor will open. Click Next after reading the description to move to the 
next step. 


You can use an MQ Semice to define the inferacton between IBM integraton Bus and WebSphere MO appications 


Ths MQ Semice editor helps you discover queves thal easing Queve Managers define, and then use these queues to define a WSDL file to use with the 
IBM MQ Service definition specification ( Pac MAQ3) > 


The MQ Serace editor defines the following steps for creabng a new MO Sernice 


. Descnpbon: A quick introduction to an MQ Serice 
Connect Connect to he MO system either using a local bindings connection, or a remote chent connecton. 
. Select Resources: Select the queues discovered from the Queue Manager that are used by the MO Sernice 
MQ Configuration Opbonally, configure sethngs for the MQ headers that are used by request and response messages. 
interface: Configure the types of the messages used on the sence interface 
Summary Rewew the MO Semce 


Application 


MQ Service eo — _) MQ Service 


om 


After you create an MQ Serice, you can use if to creale and configure MQ nodes. You can drag the MQ Sermice onto the Message Flow editor, or onto an 
MOinput node or MOOutpul node. 


Click here for additional information on MQ Services. 
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4. Specify the queue manager name as IB9QMGR and press the Test Connection link to ensure 
that the connection attempt was successful. If successful, you get the Connection was tested 
successfully feedback. 








all “MQS_addEmployeeRR.ser MO ee <i - | 
« 1.Description + « 2.Connmect + 3. Select Resources + > > 
Type of connection: Local binding connection = 
Queue Manager Name: LIBSQMGR 9 
CCOT file URL: Select 
Host or IP: localhost 
Port: 1414 
Channel Name SYSTEM.BER.CO NFIG 
< Previous Next > 


5. Click Next. 
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The dialog will show you a list of queues from the IB9QMGR queue manager. 


Choose Select Resources for Request-Response operation. 


To restrict the number of queues in the view, in the Filter Text field tyoe SERVICE (this list of 
queues with SERVICE in the first part of the name will appear). 


Highlight SERVICE.DISCOVERY.DB.ADD.IN in the list of queues and click the Select Request 
button (the queue name will be copied to the Select Request field). 


‘ull "MQS_addEmployeeRR.service 52 =e 


e 1.Descrption » ¢ 2.Connect » 3. Select Resources » > 


Query and select the resources from the target system 





@) Select resources for Request-Response operation 
Select resources for One-Way operation 


Message Exchange Pattern: 


Filter Text: SERVICE 
—— os “| System Queues [] Dynamic Queues 


To discover MQ Service, select a queue from the following list, then click Select Request to make it your Request queue. Repeat this step, but click Select Response to select a 
Response queue. (If the list of queues is empty, click Refresh queues to refresh the list) 
| SERVICE.DISCOVERY.DB.ADD.IN 


Select Request}) | SERVICE.DISCOVERY.DB.ADD.IN | x 
"SERVICE. DISCOVERY.DB.ADD.OUT 


Jil) SERVICE.DISCOVERY.DB.DELETE.IN | Select Response | 
| SERVICE.DISCOVERY.DB.DELETE.OUT | 
ji) SERVICE.DISCOVERY.DB.READ.IN 

ji) SERVICE.DISCOVERY.DB.READ.OUT 
SERVICE.TEST 
SERVICE.TEST.RETRIEVE 














| Refresh queues... | 


< Previous 
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__f. Now highlight SERVICE.DISCOVERY.DB.ADD.OUT in the list of queues and click the Select 
Response button (the queue name will be copied to the Select Response field). 


e” 1.Description + oe 2.Connect + « 3.Select Resources + o 4.MQ Configuration + 5. Servicelnterface + 


Query and select the resources from the target system 


®) Select resources for Request-Response operation 
Select resources for One-Way operation 
Filter Text: SERVICE 


|") System Queues [| Dynamic Queues 


Message Exchange Pattern: 


Include Resources: 


To discover MQ Service, select a queue from the following list, then click Select Request to make it your Request queue. Repeat this step, but click Select Response to select a 
Response queue. (If the list of queues is empty, click Refresh queues to refresh the list) 


SERVICE.DISCOVERY.DB.ADD.IN 


SERVICE.DISCOVERY.DB.ADD.OUT 


| SERVICE-DISCOVERY.DB.DELETEIN 
iil) SERVICE,DISCOVERY.DB.DELETE.OUT 
iil] SERVICE.DISCOVERY.DB.READ.IN 
iil SERVICE.DISCOVERY.DB.READ.OUT 
iil) SERVICE.TEST 
iil) SERVICE.TEST.RETRIEVE 


Refresh queues... 





__ 8. ~~ Click Next. 
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9. Note that Request / Response message headers can be configured. We do not need changes, 
So Click Next. 


e” 1.Description »  2.Connect + oe 3.SelectResources » «” 4.MQ Configuration + 5. Service Interface + 


Configure MQ headers for request and response messages 





~ Request Message Headers 


CCSID: 

Format: 

Message type: Request 
Persistence: 

Message ID: 

Correlation ID: 


Expiry: 
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__10. Onthe “5. Service Interface window,” click the Click to select message... link for the Input 
Operation. 


eo 1.Description +  2.Connect + oe 3.SelectResources » of 4.MQ Configuration » Reet eS oar ed 


Configure your interface and advanced binding parameters 


= Interface 











MQS_addEmployeeRR 


_— 

















http://MQS_addEmployeeRR 











@) Use XML schema types ©) Use XML schema elements 











Operation | Message = | 


“2 SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operation 





Next > 
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__11. Inthe Select XSD Type window, highlight EmployeeType from the list of Filtered data types 


and click OK. 
() Select XSD Typ 





Filter and select an XSD type that describes your message contents. 
This list contains the XSD types from your MQ Service library. 


Filtered data types: 


[ise 











| Qualifier: 
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__12. Repeat steps 10 and 11 for the Output operation. The message type for the Input and Output 
operations will be updated with the EmployeeType. 


ef 1.Descnption » e 2.Connect » oe 3. SelectResources +» & 4.MQ Configuration >» o& 5.Servicelnterface + « 6. Summary 


Configure your interface end advanced binding parameters 


MQ5_addEmployeeRR 


Namespace http://MQS_addEmployeeRR 








Message Configuration ® Use XML schema types ©) Use XML schema elements 
+ Operations 
Operation Message 


Sf  SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Cperation 





__ 13. Click Next. 
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__ 14. On the final Summary screen, review the Service structure and click Save. 


f 1.Description » & 2.Connect » of 3.SelectResources + ef 4.MQ Configuration » ef 5. Service interface > 


Review the Service structure and the list of files that are generated when you save a Service 











a (¢ Interface 
4 22 MQS_addEmployeeRR 
a €§ MQS_addEmployeeRR 
a “f SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operation 
1 EmployeeType 
Gi EmployeeType 
4 (| Data Types 
is] Employee 


You can drag the generated Service onto the conesponding node on the Message Flow editor. This action configure: the node so that it calls the discovered system. 
To make additional edits to the elements of the Service, use the service editor 


< Previous 


_.. VO: 





__ 16. After it is saved, the Toolkit Navigator will show the newly created service under Services in the 
serviceDefinitions Library. 


‘aa “APP licatior Jevelopment xs Patterns Explorer | e = S Sie C 
Application Development N 
4 BA serviceDefinitions 
4 ~S Schema Definitions 
4 && http://www.serviceDisco.com/Employee 
Ss) aale fe 8 
4 > Services 


32 SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operation 


4 \™ Resources 
4 €& http://MQS_addEmployeeRR 
29 MQS_addEmployeeRR.wsdl 
| [S) MQS_addEmployeeRR_InlineSchema.xsd 
4 \~ Other Resources 
4 lam SAMPLE 
*t2] SAMPLE.dbm 





We will use this service when creating a message flow later in the lab guide. 
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5.3.3. Publish the MQ Service to an Integration Registry 


Discovered services can be stored in an Integration Registry. Each Integration Node has an Integration 
Registry that can be used to store Policies and Services. You will now store the MQ Service you just 
created into an Integration Registry associated with IB9NODE. 


ele 


Open the Integration Registries view in the IIB Toolkit. If it is already visible, skip ahead to step 


3. 


Select Window—Show View—Other 


Help 
















r$ + y Bf : &~C 
[Application Development £3. “i, Patterr 
Application Development 


4 BA serviceDefinitions 
4 (= Schema Definitions 
a €& http://www.serviceDisco.com/En 
[S) Employee.xsd 


42 SERVICEDISCOVERYDBADDIN 
a o> Resources 
a £& http://MQS_addEmployee 
@ MQS_addEmployeeRR 
iS) MQS_addEmployeeRR 
4 (S Other Resources 
« lem SAMPLE 
én] SAMPLE.dbm 


New Window 


New Editor 


Open Perspective 


PDP show View 


Customize Perspective... 


Save Perspective As... 
Reset Perspective... 
Close Perspective 


Close All Perspectives 
Navigation 


Show Error View 
Show Properties 


Preferences 
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Alt+Shift+Q, L 


OY 


OOF Mme we 





uick Starts 
Application Development 


Data Project Explorer 


caeea 


: 


Data Source Explorer 
Deployment Log 
Integration Nodes 
Integration Registries 
Outline 

Palette 

Patterns Explorer 


Alt+Shift+Q, O 


Problems Alt+Shift+Q, X 


Properties 
Tasks 





Alt+Shift+Q, Q 
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2. Open the Integration Development folder and select the Integration Registries view. Click 
OK. 


type filter text 
» > Debug 
> (& DFOL 


» > Help 
(= Integration Development 


+= Application Development 

“bs Data Analysis Model 

©) Data Analysis Sample Documents 
fq. Data Filter 





¥ Data Paths 
Deployment Log 
4), Impact Analysis 

. Inte ration Nodes 


Mess ge Flow View (Read On ly) 
» (& Integration Patterns 














3. The view shows the contents of the Integration Registry associated with each IIB Node. The 
view will automatically attempt to connect to Integration nodes that are up and running and 
expand the IB9SNODE Registry view to see two folders, Policies and Services. 


C) Properti ry Proble Os. Outline 2) Tasks sss Deploy (22. Integra ¢ 








F ot | Integration Registries. 
r) A Integration Registry on IBSNODE 


Rs Policies 


4 ®© Services 
All) MQS_retrieveEmployeeRR 
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4. In the Navigator view, right-click on the MQS_addEmployeeRR.service entry and click Publish 
to Registry.... 


ey Sd, Patterns Explorer| SegY’* 0) ( 


Lee ane 





4 BA serviceDefinitions 
4 | Schema Definitions 
a % http://wvow.serviceDisco.com/Employee 


(S| Employee.xsd 
a Services | 
4 ill) MQS_addEmployeeRR.service Nn 3 _ 
| ea REI | ew , 
%@ SERVICEDISCOVERYDBAD: 
a \% Resources Open 





a er http://MQS_addEmple Open With > 
B MQS_addEmploy 
[S| MQS_addEmploye: Copy 


4 \* Other Resources Paste 
4 leq SAMPLE D 
elete 
SAMPLE.dbm 
Move... 
Rename... 
Add Bookmark... 











Publish To Registry 
Select the integration node that contains the Integration Registry to which you want to publish your Service 
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6. Inthe Integration Registry view, you will now see the MQS_addEmployeeRR service in the 
Services folder. 


[ Properti |[®. Proble | S= Outline | 4) Tasks ES Deploy | 24 Integra 52 
p | ploy g 


|e 


4 dig Integration Registries 
4 J Integration Registry on IB9NODE 
5 Policies 


4 (© Services 
all) MQS_addEmployeeRR 
all) MQS_retrieveEmployeeRR 





The service MQS_retrieveEmployeeRR has been stored in the registry by “another” Integration 
Bus developer and will be used later in this lab guide. 


Other developers that have access to the IB9NODE Registry will be able to use this service 
definition stored in the IB9NODE Registry. Right-clicking on the service definition name and 
choosing the option Import to workspace... will copy the definition into a library of your choice 
within the workspace. (There is no need to do this as we already have a copy of the service 
in the serviceDefinitions Library). 


5.4 Database Services 
5.4.1. Discover the Database Service 
You will now create a Database Service based on the SAMPLE dbm file that we imported earlier. You 


will create a Database Service that will be used to perform add (Insert) and retrieve (select) operations 
on an EMPLOYEE table in the SAMPLE database. 
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Right-click on the serviceDefinitions Library and choose New—Database Service. 














New | mij Message Flow 
Manage Library references BG Subflow 
Manage included projects | EP Message Mode... 
c+} Message Map 
Focus on Library RE ESQL File 
Convert to Application eg Broker Srhiema 
Export XSDs from Library ®< Adapter Connection 
() Database Definition 
Migrate : 
=8 Data Lineage Documents 
Go Into Ci BAR file 
4 al MQS_ade Copy ig Integration Bus Test Client 

SERVI fe Decision Servic 

s® Resou Paste F écision ce 

a & Delete lil 

, Move... Aj | 
Rename... eet 
a © Other eee A) Application 
4 ka SAMPLE ie gy Import... (S| Integration Service 
oh) SAME ey Export... BA Library 












































2. Name the new service DBS_employee. Click Finish. 


® Create New Database Service 





Create New Database Service 


Create a new service by discovering the resources from a database definition 
file ( dbm). Specify the Service name and the Library for the service. 


Service Name: — employee | 
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3. The Database Service editor will open. Read the description and click Next. 


A Database Semce can be used to define the interaction between IBM ton Bus and a database. The Database Semice editor 
sy rg metadata discovered from the database, with information about the required database interaction, to create a Database 


The Database Semce editor contains the following steps for creating a new Database Semce: 


1. Database Definition: Select an exsting database definition file (.dbm file) that descnbes the database contents (for example, the 
database schemas, tables etc) and connection information for the database. If you do not have a database definition file, click New to 
discover database services from your database. 


. Select Resources: Select a table on which you want to expose operations. 

_ Service Operations: Create operations and define their semantics. 

. Semice interlace: Rewew a summary of the logical interlace and operatons you defined 
Summary. Review the semice structure and the artifacts generated 


When the Database Semce is saved, the folowing artifacts are generated: 
« <DatabaseService> wsdl This file describes the service interface and the database binding that captures the semantics of the 
operations on the database. 


« <DatabaseService> xsd This file descnbes the inputs and outputs of the database operations. 
« <DafabaseService> sermice: This file captures the metadata that is used dunng the discovery process 


Integration Service 


SOAP/http 





4. On the Database Definition section, click the Select... button. 

















iChat Ge Sele w ucaDane Geiniion fhe wnd Speci an ODBC Gata sourceninnie 


Database definition file": 











ODBC data source name": 
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5, Select the SAMPLE.dbm file and click OK. 
(>) File Selection nnn eae = 








eo 1.Description » « 2. Database Definition + 3.Select Resources » (Service Opera 
Create or select a database definition file, and specify an ODBC data source name 


Database definition file": /SAMPLE/SAMPLE.dbm 
ODBC data source name"; SAMPLE 
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7. | Onthe Select Resources page, click the EMPLOYEE table. Notice the preview of the table 


changes, giving an indication of the columns defined in the table. Click Next. 


«” 1.Description » « 2. Database Definition + o 3.Select Resources » 4. Service Operations + 


Select resources 


Select the single table you wish to expose operations from 


Preview of columns in selected table: EMPLOYEE 











a 4) SAMPLE 
a &2 DBADMIN 
[S CL_SCHED 


Fl PROJECT 
PROJACT 

3 EMPPROJACT 
ACT 

fT] IN_TRAY 

[= ORG 

ff STAFF 

[ SALES 

fl STAFFG 
EMPMDC 
PRODUCT 
FS INVENTORY 
CUSTOMER 
PURCHASEORDER 
ES CATALOG 
FA_SUPPLIFRS 


























32 EMPNO 
B FIRSTNME 
MIDINIT 
LASTNAME 
WORKDEPT 
PHONENO 
HIREDATE 
JOB 
EDLEVEL 
SEX 
BIRTHDATE 
SALARY 

& BONUS 

— COMM 


a fs Oe Ce Ooe Oe Coe oe oe ooo 


; JB. x oS e 
oe 1.Descnption + e 2. Database Definition » oe 3.Select Resources » CRT te orig b elnterface > 
Specify operation details 
|< Add operation | 
€9 EMPLOYEE_OPS_GROUP _ You have selected the EMPLOYEE table from the SAMPLE database. 
Add SELECT, UPDATE, INSERT, or DELETE operations to the default port type (EMPLOVEE_OPS_GROUP). 
After operations have been added, select the operations to configure them here. 
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9. Onthe Add a database operation window, choose SELECT as the operation type and keep the 
default service operation name of retrieveEmployee. Click OK. 


0) Add a database orton = 


lect operation type 


] 

. 

, ‘s — a 
a 





On the selected table: EMPLOYEE 





__10. A list of column names that will be output parameters of running the retrieveEmployee 
operation will appear. EMPNO (defined as a key) will be selected by default. Right-click on the 
EMPLOYEE table and choose Select All Columns. 


o” 1.Description + « 2. Database Definition + o 3. Select Resources + « 4. Service Operations + « 5.Servicelnterface + oe 6. Summary 


Specify operation details 
i Operation Type: SELECT -- Selected columns from the table will be output parameters of the operation. In the Output Colurnns tab set the sort preferences for the columns. 
In the Conditions tab set which rows will be returned. 
ef Add operation 
- @ EMPLOYEE_OPS_GROUP 
£9 retrieveEmployee 


r] HIREDATE 


' 110) JOB 
17 ent evel 


—— — 


| Column Sort Order 
EMPLOYVEE.EMPNO 
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__11. Click the Conditions tab. 


é 


3 


eo 1.Description + e 2. Database Definition » ¢ 3.Select Resources » o 4.Service Operations » « 5. Servicelnterface » ¢ 6. Summary 
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"Specify operation detail 


| i Set the sort preferences for the output columns. 


_ SP Add operation 
 @ EMPLOYEE_OPS. GROUP 
ES retrieveEmployee 





“| EMPNO 
| FIRSTNME 
| MIDINIT 
| LASTNAME 
| WORKDEPT 
| PHONENO 
| HIREDATE 
~| JOB 

| FMI FVFI 


| Output Columns fl Conditic 


Column 
EMPLOYEE.EMPNO 
EMPLOYEE.FIRSTNME 
EMPLOYEE.MIDINIT 
EMPLOYVEE.LASTNAME 
EMPLOYEE. WORKDEPT 
EMPLOYEE.PHONENO 


rant Awe bora re 
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__12. Click a blank entry under Column. From the drop down, choose EMPLOYEE.EMPNO. The 
Operator “=” and Value “:empno’” (the input parameter) will be set automatically. Click Next. 


f) "DBS_employeeservice £3 


o 1.Description + « 2. Database Definition » « 3.Select Resources + o 4. Service Operations + 5. Servicelnterface + o 6. Summary 


Specify operation details 


i Operation Type: SELECT -- Selected columns from the table will be output parameters of the operation. In the Output Colurnns tab set the sort preferences for the columns. 


In the Conditions tab set which rows will be returned. 














FS retrieveEmpl 
ie eee EMPLOYEE 





EMPNO 
FIRSTNME 
MIDINIT 
LASTNAME 
WORKDEPT 
PHONENO 
HIREDATE 


JOB 
FM FVEI 


mS Dd 


| Output Columns Conditions 
Column 

EMPNO — 

JEMPLOYVEE-FIRSTNME 

JEMPLOYVEE.MIDINIT 


JEMPLOYVEE.LASTNAME 
{EMPLOVEE.WORKDEPT 











< Previous 
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SSS SaaS SSSS SESE SEES ELIS SSSLSSELSSSESSSON 





Value 


empno 


o fF ) 





AND/OR 
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__ 13. On the 5. Service Interface screen, click the Open file... link on the Input - retrieveEmployee 
column. 


e” 1.Description » « 2. Database Definition + oe 3.Select Resources + oe 4. Service Operations + esa | + ef 6. Summary 


Review the logical interfaces and operations created in this service 


= Interface 





| EMPLOVEE_OPS_GROUP 











| http://DES_employee 





| Operation | Message | 


2 retrieveEmployee 





[fe] retrieveEmployee 


"| [g] retrieveEmployeeResponse 











__14. A message will appear indicating that the (xsd) file does not exist. Click Yes to save the editor 
file and generate the file. 


The file that contains the message does not exist. Save the Service editor to generate 
the file that contains the message. 


Do you want to save the Service editor now? 
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__15. Once generated, the retrieveEmployee (input) xsd file (DBS_employee.xsd) will be shown. 
Close the DBS_employee.xsd file (click on the X). 


2) DBS_employee.service _| |S] DBS_employeexsal © 





View: Detailed w (?) 


[H] RetrieveEmployeeType 


retrieveEmployee- 
Le ploy ia [e] empno (empnoType) 


Design ‘Source. 
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__ 16. Clicking on the retrieveEmployeeResponse Open file... link will also show the generated xsd 
file for the output (note the columns you choose to be output are included). Click the + sign in 
the schema to get the list. Close the DBS_employee.xsd file. 


+ Operations 
Operation Message 


SF retrieveEmployee 














©) Input fe] retrieveEmployee 
Zl Output | [fe] retrieveEmployeeResponse 
£) DBS_employeeservice | [5 = = 5 





Baile View: Detailed 
RetrneveEmployeeResponselype 
(i retrieveEmployeeResponse - Ls , 


fe) row [0.."] (rowType) i | 





J) DBS_employeeservice _—|_-[S| DBS_employeescse ce =e 


View: Detailed 


(rowType) 
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(i) RetrieveEmployeeResponselype 
{e) row [0.."] (rowType) 


| [e) retrieveEmployeeResponse - 


[e] EMPNO 

fe] FIRSTNME 

[e] MIDINIT 

{é) LASTNAME 
je] WORKDEPT 
{e] PHONEN® 
{e) HIREDATE 

[e] JOB 

{e) EDLEVEL 


[e) SEX 

fe] BIRTHDATE 
[fe] SALARY 

(e] BONUS 

{e] COMM 


(EMPNOType) 
(FIRSTNMEType) 
(MIDINITType) 
(LASTNAMET ype) 
(WORKDEPTType) 
(PHONENOType) 
date 

VOBType) 

short 

(SEXType) 

date 

decimal 

decimal 


decimal 
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__17. Click Next to see the 6. Summary page. Since you saved the file to generate the 


DBS_employee.xsd file, the save button will be inactive since there have been no changes since 
the last save. Close the DBS_employee.service editor. 


e 1.Description » o 2. Database Definition + o 3.SelectResources + of” 4. Service Operations + o 5. Servicelnterface + 


Review the Service structure and the list of files that are generated when you save a Service 














la 0M Interface 
a DBS_employee 
a @ EMPLOVEE_OPS_ GROUP 
4 iy retnieveEmployee 
) retrieveEmployee 
@) retneveEmployeeResponse 
a Jy Senice 
(@ db:address location="odbe:dns:SAMPLE” 
4 (4% Data Types 


[5] DBS_employee 





You can drag the generated Service onto the corresponding node on the Message Flow editor. This action configures the node so that it calls the discovered system. 
To make additional edits to the elements of the Service, use the service editor 


< Previous 





__18. Note now that you have created the Database Service, the Navigator has been updated to 
include the Database Service in the list of services in the serviceDefinitions Library. 


on . 8. Patterns Explorer 





4 BA serviceDefinitions 
4 (5 Schema Definitions 
a €& http://www.serviceDisco.com/Employee 
(S) Employee.xsd 
4 (© Services 
4 4) DBS_employee.service 
“Ef retrieveEmployee 


» (SS Resources 
4 iil) MQS_addEmployeeRR.service 
22 SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operation 
> (= Resources 
(=) Other Resources 
4 lam SAMPLE 
°%) SAMPLE.dbm 
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5.4.2 Add an operation to the Database Service 


Additional database operations can be added to a discovered Database Service. The application that 
you will create later in this lab will add and retrieve data in the database. When you discovered the 
Database Service you added the “Select” operation. This will be used to retrieve data from the database 
by the application. You will now edit the existing discovered Database Service and add the Insert 
operation so that you can add data to the database using the Database Service. 


1. | Open the Database Service editor by double clicking on DBS_employee.service in the 
serviceDefinitions Library. 


F) Application Development be Sh Patterns Explorer Sees’ “ca 
Application Development New.../ 


4 BA serviceDefinitions 
4 (5 Schema Definitions 
4 §& http://www.serviceDisco.com/Employee 
'S) Employee.xsd 





DBS employee.service 
mS retrieveEmployee 
Resources 
a ill) MQS_addEmployeeRR.service 
¥ SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operation 
Resources 








4 \™ Other Resources 
4 SAMPLE 
*t) SAMPLE.dbm 


2. Inthe Database Service editor, click 4. Service Operations. Note the retrieveEmployee 
operation that we created earlier. Click + Add Operation. 


£} DBS_employeeservice [3 7 = 


of 1.Desenption » = 2.Database Definition + < 3. Select Resources |! 4.Service Operations [ oe 5, Service Interface + 6. Summary 





Specify operation details 





; &9 EMPLOYEE OPS GROUP | You have selected the EMPLOVEE table from the SAMPLE database. 
f® retrieveEmployee 
Add SELECT, UPDATE, INSERT, or DELETE operations to the default port type (EMPLOVEE_OFS_ GROUP). 


After operations have been added, select the operations to configure them here. 
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3. Choose INSERT from the Select operation type drop down. The service operation name will be 
set to createEmployee. Click OK. 


(2) Add a database operation 
Select operation type _ 


| Service operation name 


| 








On the selected table: EMPLOYEE 





4. As before, right-click on the EMPLOYEE table and chose Select All Columns. 


wf 1.Description » o 2, Database Definition + o 3.Select Resources » o 4.Service Operations + « 5. Service Interface + o 6. Summary 


i Operation Type: INSERT -- Selected columns from the table will be input parameters of the operation. In the Specify Values tab, specify the values for the columns to insert. 
ap Add operation 
@ EMPLOYEE_OPS_GROUP 
£} retrieveEmployee 
£§ createEmployee ooo 
~) EMPNO 
|] FIRSTNME 
() MIDINIT 
[] LASTNAME 
[-] WORKDEPT 
|] PHONEND 
|_| HIREDATE 
L] JOB 
[) FP EWEI 


SS SS 8 EB SS AS A Os EEN A EE SEEE AL AOSESARESESA RESEE A CSSA RESELLER RESELLER A LSRE ALS RESID ASSES ASSES ASSES AESGAS SAGES ASESED AAERD AAA SAGES ASSESS. BEGEAAAERA AASEED ASSES ASSESSES SAS SAGE SSE SESS SEES RESEDA SEA ASE ASE ASSESS LEER ES BASEL: 


bal 


"Specify Values 


Column 
EMPHIO 
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__5. — The values in the columns fields will be automatically generated. Click Next. 


 1.Description » o 2, Database Definition + o 3.Select Resources » of” 4.Service Operations » « 5.Servicelnterface + oe 6. Summary 


"Specify operation details 
i Operation Type: INSERT -- Selected columns from the table will be input parameters of the operation. In the Specify Values tab, specify the values for the colurnns to insert. 
a> Add operation 
@ EMPLOYEE_OPS_ GROUP 
F} retrieveEmployee 
£§ createEmployee — 
EMPNO 
FIRSTNME 
hIDINIT 
LASTNAME 
WORKDEPT 
PHONENO 
HIREDATE 


fata’ 


ISA 








spectyVaues 
Lone we 


| EMPNO 
FIRSTNME 
MIDINIT 
LASTNAME 
WORKDEPT 
PHONENO 
| HIREDATE 
Joe 

| EDLEVEL 











__ 6. Click Next. 


of 1.Descniption » o 2. Database Definition + eo 3.SelectResources » o 4. Service Operations + esa) + ef 6. Summary 


Review the logical interfaces and operations created in this service 


| EMPLOYEE_OPS_GROUP 


— 


| http://DBS_employee 
_ Maes siehioaicin is ata tad 





Message 
42 retrieveEmployee 
| ! Input fe) retrieveEmployee 
: retrieveEmployeeResponse 
| @) Output | ployeeRespo 











—- | | 


fe) createEmployee 
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7. _Onthe summary screen, note the createEmployee Operation has been added to the 
EMPLOYEE OPS GROUP and the explanation on how to use the Database Service. Click 
Save to add the createEmployee operation to the Database Service. 


‘| VES @mpioyee.ser ice i. 
ef 1.Description » o 2. Database Definition + oe 3.SelectResources + o 4. Service Operations + oe 5. Servicelnterface + 


Review the Service structure and the list of files that are generated when you save a Service 


la 0M Interface 
4 2 DBS_employee 
a © EMPLOYVEE_OPS_GROUP 
4 iy retnieveEmployee 
) retrieveEmployee 
A] perievec nit eosesponce 








( db:address location="odbe:dmsS AMPLE” 
4 (& Data Types 
[s) DBS_employee 











9. You will now see the createEmployee operation in the Navigator. 


2 Si, Patterns Explorer 


4 BA serviceDefinitions 
4 (S Schema Definitions 
a & iat //wwew.serviceDisco.com/Employee 


= aie scares 
= retrieveEmployee 


pS T= Resources” 
a ill) MQS. addEmployeeRR.service 
¥ SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operation 
. (& Resources 
(=) Other Resources 
4 lem SAMPLE 
$3] SAMPLE.dbm 
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5.9 Using discovered services 


You will now create an application that will use both the MQ request/response service and Database 
Service that you just created. MQ Services can be called or implemented when using them in an 
Integration Bus message flow. The application you will create in the next few sections will demonstrate 
how each of these options can be used to create an application based on the MQ Service and Database 


Service. 


5.5.1 Create an application 


the menu. 


EF Application Development £3 > 82, Patterns Explorer 
Application Development 


BA serviceDefinitions 
-S, Schema Definitions 
£2 http://www.serviceDisco.com/Employee 
S$) Employee.xsd 
& Services 
£) DBS_employee.service 
‘3 createEmployee 
2 retrieveEmployee 
4“) Resources 
ill) MQS_addEmployeeRR. service 


1. Create a new application. Click New...and then select Start by creating an application from 


& Ny Ss 
New... | 


Quick Starts 
| New Artifact 

af Message Flow 

48 Subflow 

[Sy Message Model... 

fe Message Map 

Be ESOL File 


[=> oa 
ee Decision Service 


ili] MQ Service 


% SERVICEDISCOVERYDBADDIN_SERVICEDISCOVERYDBADDOUT_Operatic 


™ Resources 
Other Resources 
tga SAMPLE 

Sm) SAMPLE.dbm 
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Ply Database Service 


Quick Start 


| — 
| [Al Start by creating an application 


rs’ Start by creating an integration service 
a start by creating a library 
or | Start from WSDL and/or XSD files | 
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Create a new application 


An application ts a deployable container that provides isolation at runtime. Enter a name for the new 
application. 


Application name ManageEmployee | loyee 





3. Create a reference from this application to the library that contains the services you defined, by 
checking the box for serviceDefinitions. Click Finish. 








Create a new application 


Specify dependencies on libraries. 


The following libraries will also be included as they are referenced by the checked libraries. 
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5.5.2 Create a flow to implement the MQ Service 


The flow you will now create will use the MQ_addEmployeeRR service you created in order to 
implement the MQ Service. You will also use the Database Service you created earlier in this flow. 


1. Inthe Navigator, expand the ManageEmployee application and click (New ...), 












=. Apoli a 8 , lore: asic 
Co Appl Hibs © Pattems Explorer] 

| €e6%° 
-. Development New...! 
| 4NIAl ManageEmployee| 


| 4 BA serviceDefinitions 
OS, Schema Definitions 
>» Services 
~ Other Resources 


2. Select Message Flow from the list of options. 


ss Application Devel £2 oe, Patterns Explorer). “~ OF 


es = < “a 
= i S 


Application Development New... 


[A] ManageEmployee 
(fy) References 
* (New...) 
mA serviceDefir, 


_ New Artifact 
5. Schema! ie ‘ 














& Services Create a new artifact. 


~ Other Re 8 
28 Subflow 
Message Model... 
fe. Message Map 
GE ESOL File 
cP Decision Service 


f% Broker Schema 
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__3. Name the message flow addEmployee_ImplementMQS and click Finish. 
©) New Message Flow 


Create a new message flow 


Select a container for the new message flow 


Container: Ma nageEmployee + 


Message flow name: J addEmployee ImplementMQ$S 


Flow organization 
Y) Use default broker schema 


(default broker schema) 





__4. The message flow editor will open. In the serviceDefinitions Library, drag and drop 
MQS_addEmployeeRR.service from the Navigator onto the editor canvas. 


When prompted, choose To implement the MQ Service definition, configure an MQInput 
node and MQOutput node on your flow. 


FA. Apphcatron Devel ii 22, Patterns Explores, “~~ | (2 addEmployee_ImplermenthiQS.msgflow © 


oS - G, : 4 = Palette 
Application Development New...||| hz 9 Be « 
(A) ManageEmployee ha Favorites 
S) Flows ing WebSphere MQ 
4) addEmployee_ImplementMQ5.msgflow (oes JIS 
TR) References (2 HTTP 4 
BA serviceDefinitions | CoWebs gee ' 
S. Schema Definitions 


OS Services SCA ‘ 
£] DBS_employee.service i Io” Te 
Ji) MQS_addEmployeeRR.cervice _-¢ Routing 
Other Resources in) NET 
\{j Transformation 
Lg Construction 
pj Database 
(@ File 
imp Email bd 
Graph User Defined Propertie: 
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__5. Note that when implementing the service, the following are automatically created: 


__a. an MQ Input node (specified with the queue name SERVICE.DISCOVERY.DB.ADD.IN) 
__b. anMQ Header wired to an MQ Output node (specified with 
SERVICE.DISCOVERY.DB.ADD.OUT) 


- | *addEmployee_ImplernenthiQ3.msgflow ¢-: ~ 
| <& Palette 

>) & 

Lo Favorites 

leq WebSphere MQ 

Look JhAS 

(xt HTTP 

Lo Web Services 
(SCA | P 
igh WebSphere Adapters 
Gi Routing 

Va MET 

U4) Transformation 

La Construction 
CB Database 

\g> File 

ba Email be 
Graph User Defined Properties 









MQS_addEmployeeRR_MQlnput 





MQS_addEmployeeRR_MQHeader MQ5_addEmployeeRR_MQOutput_# | 








[7 Properties 22 [ Problems| 5= Outline) 4) Tks | Fl Deployment Log | Ao Integration Registries 5 
a MQ Input Node Properties - MQS_add& 
Description 

Basic Quevename” | 


Input Message Parsing 





| Browse MQ Senic CS... 


Parser Options 
Advanced 


Since we are now implementing the MQ Service, the message flow has been designed for 
request / response. This message flow accepts the request on the input queue and responds to 
the caller on the output queue. You will now use the Database Service to create the request. 
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6. Drag and drop a Compute node (in the Transformation drawer) onto the canvas. Name the 
node GotoDatabase. 


Wire the Out terminal on the MQ input node (MQS_addEmployeeRR_MQlInput) to the In 
terminal on the GotoDatabase node. 


Wire the Out terminal of the GotoDatabase node to the In terminal of the MQ header node 
(MQS_addEmployeeRR_MQHeader). 





| 25 Transformation 
|, NETCompute 
|} Mapping 


| y ¥SLTransform | 
|g@@ Compute . - , a 









2 JavaCompute es GotoDatabase = = — . 

a PHP Compute | = — ch ——" ‘| 

Ica Construction = MQS_addEmployeeRR_MQInput MOQS_addEmployeeRR_MQHeader MQS_addEmployeeRR_MQOutput 
_Q Database 

(3? File 

say Email 

‘Ca TCP 

a CORBA 

: ott Business Decisions 


| Graph User Defined Properties | 
7. Drag and drop the Database Service DBS_employee onto the compute node GotoDatabase. 
When prompted to select the Database Service Operation, two options will be given: 


createEmployee and retrieveEmployee (you created these operations when you created the 
Database Service earlier). Select createEmployee and click Finish. 













er Applicaton D es 22, Patterns Explo ™ © ||  *addimployee_implementMQS.msgflow © == 
= ‘=. = 4 <> Palette 
Application Development New...) (>) INET S 
ry ManageEmployee io Transformation 
" Flows ™ NETCompute 
4) addEmployee_ImplementhQS.msgflow) i Mapping 
References } XSLTuansform 
BA serviceDefinitions gi? Compute = ——— 
S. Schema Definitions g@ JavaCompute = , — GotoDetabase — 
h Servic a ins | 
& Services compute i) ja |; ——— 
J) DBS_employeeservice — Confreu " : 
configure New Database Senice M 
di MiQS_addEmployeeRRervice “i Construction O op a 
Other Resources ~0 Database | Select Database Service Operation 
ig? File Specify the operation of the selected database Service to use in the message flow. Only database bindings are supportec 
sag Email 
Lea TCPIP 
rc CORBA Select o Service operation to call 
=? Business Decisions [J| createEmployee | [http://DBS employee EMPLOYEE OPS GROUP : 
“ = s || Graph | User Defined Peal Py) retrieveEmployee [ (http://DBS employee /EMPLOVEE_OPS GROUP] 
to Integra | (M8 Data So | 25. DataPr © ~ Et || CD Properties = 
= G ~ | Property 
i SAMPLE Artifact 
last modified 
narre I == _ 
path | Press Finish to create Esql file |/ManageEmployee/addEmployee Implementhigs Computecrg! 
type | 


th 6 cenviceDetinitions/ Service, DBS_employeesenice 
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Dragging and dropping the Database Service definition on the Compute (ESQL) node 


automatically creates and ESQL procedure named createEmployee. 


The ESQL procedure is automatically generated and saved in the library. It is saved in a file 


called DBS_employee.esql. The toolkit automatically opens this file. 


«1 *addEmployee_ImplementMQS.migflow 





* This file 15 generated esutaomatically. Do fot alter its Contents as any changes Bight be overwritten. 


* Database Service : 055 employee 


* Operation group : EMPLOYEE OFS GROUP 
his file is created when the Database Service is used with a Compute node 


his fileé contains an ESQL procedure definition for each operation in the Database Service 


Pic SSS SS SS Sc SCS SS So SS LSS So Fc cS SS csc Sc Sc Sc SSS Sc SCS SS SS Sc Sco Fc Sc cc SS css cS Ss Sc SS Sc Sc cS Sc Sc so ccc cP cS Sc Sec cee Fee ee eee eS 


(SSS SCS FF SS Sc CPS Sc SH SS SSS SL SSS SS FPF cc CPSs FC SSS SS SPF Fc Pc SS PSF FPP Fcc CPP Se FP SP Sc cP Ss FS SF FPS PPP cP PP FC ee Pee ee SS 


* DStabase Service Operation createbenloyeet: 


SSS Poe Se SSS SS SS SSL Lc 


CREATE PROCEDURE createEmployee (IN empno CHARACTER, IN firstnme CHARACTER, IN midinit CHARACTER, IN lastname CHARACTER, IN workdept CHARACTER, IN phor 


BEGIN 


PASSTHRU 
"IHSERT INTO ADHIH.EMPLOYEE (EMPHO, FIRSINHE, MIDINIT, LASTHAME, WORKDEFT, FHOHENO, HIREDATE, J08, EDLEVEL, SEX, BIRTHDATE, 
TO Database. SAMPLe 
VALUES (empno, firstnme, mMidinit, lastname, workdept, phoneno, hiredace, job, edlevel, sex, birthdate, galery, bonus, come); 
END: 


Close this file (DBS_employee.esq)). 


(ex *addEmployee_ImplementMQS.msgflow 2% f 





lf you need to see the procedure definition again for any reason, the file is saved in the 


serviceDefinitions Library. 


» 82, Patterns Explor | 





Application Development 


a [A) ManageEmployee 
a (= Flows 


Serres esse 


Pen errreste Presses re 


» (Gy References 

4 BA serviceDefinitions 
» CS Schema Definitions 
a 4! ESQL 


» £) DBS_employee.service 
> gil) MQS_addEmployeeRR.service 
» (SS Other Resources 
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__10. Go back to the message flow again and double click on the GotoDatabase Compute node. 





fee SS Tiandioeradien 
™ NETCompute 
=; Mapping 

4y XSLTransform = 
| @ Compute pee | = 

@ JavaCompute =, el 
‘ag PHPCompute la ~ 


\Ca Construction MQS_addEmployeeRR_MQInput MQS_addEmployeeRR_MQHeader 
| CA Database 





__11. This will open some sample “starter” ESQL code that can be used to drive the Compute node. 





CREATE FUNCTION Main () RETURNS BOOLEAN 


BEGIN 
-—- CALL CopyMessageHeaders (); 
-- CALL CopyEntireMessage(); 
RETURN TRUE; 

END; 


CREATE PROCEDURE CopyMessageHeaders() BEGIN 

DECLARE I INTIEGER i; 

DECLARE J INTEGER; 

SET J = CARDINALITY (InputRoot.*[]): 

WHILE I < J DO 
SET OutputRoot.*[I}] = InputRoot.*[I]; 
SET I = I # i; 

END WHILE; 


END; 

CREATE PROCEDURE CopyEntireMessage() BEGIN 
SET OutputRoot = InputRoot; 

END; 


END MODULE; 


We will not be using this sample “starter”? ESQL. We have supplied some code that will call the 
ESQL procedure that was automatically created by dragging and dropping the Database Service 
on the compute node. 


__12. Highlight all of the sample code (CTRL-A) and delete all the lines of code (in the next section 


you will copy some new code into it). Keep this file open in the Toolkit ready to be filled with 
code. 
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addEmploye 





>» |) RecordReplay 
) SAPFiles 
> }) SECUR 
> ad sequence 
b ad Service_creation 
4) Service_discovery 
> jo data 
> |, install 
> a resources 
> 7) workspace 
> |. setup 
)) SOAP_InputMessages 
> J) solutions 
> jo Subflows 
> a tools 
> }) Trades 
> J. Visual Studio 2010 
> ). webadmin 
> )) WESB_Conversion 
> J) Worklight 


b & Workload_Management 


Text Document 


: addEmployee_ImplementMQS_Compute.... Date modified: 7/18/2013 8:54 AM 
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PE =|] Search resources 


__| addEmployee2W_Compute.esq] 

_j) DBDemo_Ins_Upd_Ret_del_P! 

(=, Employee 

3) Employee 

_]) ManageEmployee_Stagel_Read 

_]) ManageEmployee_Stage2_Read_Add 
_j) ManageEmployeeTests 

F) readEmployee.esql 

|} RetrieveEmployee.mbtest 


F} retrieveEmployee_ImplementMQS_Compute.esal 


Uj) RetrieveEmployeeFlows 
Ui) SAMPLE 
_. TestAddManageEmployee.mbtest 





Date modified 


7/18/2013 8:54 AM 
7/18/2013 8:54 AM 


7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 
7/18/2013 8:54 AM 


__13. In Windows Explorer, navigate to C:\student\Service_discovery\resources and open the file 
e _ImplementMQS_Compute.esqlI.txt with Notepad (double-click on the file). 


~ bis 


Type 


Text Document 
Text Document 


Text Document 
Text Document 
Compressed (zipp... 
XML Document 
XML Schema File 
Compressed (zipp... 
Compressed (zipp... 
Compressed (zipp... 
Text Document 
MBTEST File 
Text Document 
Compressed (zipp... 
Compressed (zipp... 
MBTEST File 


ol 





Size: 1.16 KB 
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Date created: 6/16/2013 2:11 PM 





__ 14. Select (CTRL-A) and copy (CTRL-C) all the code from this file. 






File Edit Format View Help 
PATH DBS_emp loyee. EMPLOYEE_OPS_GROUP; 





DECLARE nS NAMESPACE http://w 





CREATE COMPUTE MODULE addEmployee_ImplementmMQs_Compute 
CREATE FUNCTION Main() RETURNS BOOLEAN 
BEGIN 









-- CALL CopyMessageHeaders(); 
CALL CopyEntiremMessage(): 


DECLARE insReT REFERENCE TO InputRoot. XMLNSC.ns:Employee; 
DECLARE EMP1 CHAR 1nsReT.EmpNo: 


CALL createEmployee(EMP1, 

insRef.FirstName, 

insRef.Initial, 

insRef.LastName, 

insRef. Dept, 

insRef. Phone, | 

eg - Soy Gard) ee es 

insRef. Job, CAST (insRef.EdLeve AS INTEGER 


insRef. Sex, 

CAST( 1959-11-17 AS DATE),| 
CAST(CinsRef.Salary AS DECIMAL), 
CASTCinsRef.Bonus AS DECIMAL), 
CASTCinsRef.Commission AS DECIMAL)); 


RETURN TRUE; 
END; 


DECLARE I INTEGER 1; 
DECLARE J INTEGER; 

=) a 

WHILE [I 


| ee ee PS 
END WHILE; 


CREATE PROCEDURE CopyEntiremMessage() BEGIN 
SET OUTDPUTROOT = InNputRoot; 





END MODULE: 
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__15. Go back to the Toolkit and paste (press CTRL-V) the lines of code into 


addEmployee_ImplementMQS_Compute.esql (you left this file open ready to be filled with 
code). 


The file will look like this: (note the call to createEmployee in the code). 


=] *addEmployee_ImplementMQS.msgflow esq *addEmployee_ImplementMQS_Compute.e 2: = |= 
PATH DBS employee.EMPLOYEE OPS GROUP; * 
DECLARE ns NAMESPACE ‘http://www.serviceDisco.com/Employee'; 


CREATE COMPUTE MODULE addEmployee ImplementMQS Compute 
REATE FUNCIION Main() RETURNS BOOLEAN 


DECLARE insKef REFERENCE [TO InputRoot.AMLNSC.ns:Employee; 


DECLARE EMPi CHAR insRef.EmpNo; 


fu 


ib 


a @ @ | 


AS INIEGER), 


€ 
mJ 
7 
.D 
.PR 
‘a 
ar | 
io 


i] 
ior Fw OD 


Lo 


mmm iu mh oO 


y AS DECIMAL), 
AS DECIMAL), 
AS DECIMAL) ); 


=| 
My 
I 
ta 
Lia 
- 
O 
i 





i 


Source 




















You can close Notepad. 
__16. Save (CTRL-S) and close the addEmployee_ImplementMQS_Compute.esq| file. 
__17. Save (CTRL-S) the addEmployee_ImplementMQS message flow. 


__ 18. Close the addEmployee_ImplementMQS message flow. 
5.5.3 Create a flow to call the MQ Service 


The flow you will now create will use the MQ_addEmployeeRR service you created in order to call the 
MQ Service. 
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1. Inthe Navigator, expand the ManageEmployee application. Highlight the Flows folder, right- 
click, and select New—Message Flow from the menu. 


£3. 8, Patterns Explor | 












Quick Starts 
Start building your application with one of 1 























Message Model ... 
4 BA serviceDi Paste = yaa) * 

> Schet Delete = g P 
a (S' ESQU Move... ae ESQL File 

e&D eens fi Broker Schema 

> kes ® Adapter Connection 

i lt. rey 
° - ao gs Import... {) Database Definition 

, ‘sii ry uci Epport... @& Data Lineage Documents 
rp & Othe Refresh a BAR file 

: ts Integration Bus Test Client 
Run in New Workbench... 


— ST Le Decision Service 





Create a new message flow 
Select a container forthe new message flow 


Container: ManageEmployee = 


Message flow name: | addEmployee_C allMOs | 
Flow organization penne enn 
(V] Use default broker schema 


roa: | (default broker schema) 



































The message flow editor will open. 
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From the serviceDefinitions Library in the Navigator, drag and drop the MQ Service 
MQS_addEmployeeRR.service onto the message flow canvas. When dropped onto the 
canvas you will be presented with two options — click the option to Call an MQ Service by 
creating an MQOutput node, and an MQGet node that process the request and response. 


Fi Application Dev 3 2, Patterns Explore OO 


ees- 


[2] ManageEmployee 
SS! Flows 
M addEmployee_CallMQS.msgflow 
(20 addEmployee_ImplementMQ$.msgflow 
e# ESOLs 
[fy] References 
Be serviceDefinitions 
3. Schema Definitions 
“1 ESOLs 
3 DBS_employee.EMPLOYEE_OPS_GROUP 
[esis DBS_employee.cig! 
Oy Services 
£) DBS_employeeservice 
all MQS_addEmployeeRR.service 
&2 SERVICEDISCOVE?YDBADDIN_SERVICED 
+ Resources 
(>) Other Resources 


| lap NET 


Lo Database 


1 addEmployee_CallMOS.msgflow ©: 
| <> Palette 

a & 

La Favorites 

iq WebSphere MQ 

ua JMS 

(gj, HTTP 

\@ Web Services 


| GASCA 


‘gh WebSphere Adapters 
+ Routing 
























(iy Tren 


| &) Te implement the MO 


‘Construction we PY 


> File 


hag Email 


(creat. 


Three MQ nodes will be created on the canvas. 





<> Palette 
k\o i 
icy Favorites 
Ga WebSphere MQ 
\ Gas JMS 
Ga. HTTP 
‘(@ Web Services 
\CQ,SCA 
gs WebSphere Adapters 
Ica Routing 
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-_o——— — al —- 


MQS_addEmployeeRR_MQHeader MQS_addEmployeeRR_MQOutput MQS_addEmployeeRR_MQGet 


an MOlnput node and M 
de and pace et in oe tf 








= 
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__5. — Note the MQ Output node has been pre-filled with the Request queue you defined in the MQ 


service earlier. 


) Properties £3 *) Problems a Outline! 4) Tasks | Fj Deployment Log va Integration Registries 


&|) MQ Output Node Properties - MQS_addEmployeeRR_MQOutput 





Basic 

Advanced Queve managername IBIQMGR 
Request Queue name RVIC 
Validation 

Monitoring 


| Browse MQ Services... | 


The MQ Get node has been pre-populated with the queue you specified as the Response 


queue. 


) Properties £2 [| Problems = Outline) 4) Tasks! Deployment Log a Integration Registries 


& MQ Get Node Properties - MQS_addEmployeeRR_MQGet 


Description 





Basic Queue name” § SERVICE.DISCOVERY.DB.ADD.OUT 
Input Message Parsing 

Parser Options 
Advanced 

















Browse MQ Services... | 


! 
| 
- 


6. The message flow will write to the SERVICE.DISCOVERY.DB.ADD.IN queue and wait until a 


response is received on the SERVICE.DISCOVERY.DB.ADD.OUT queue (thereby calling the 


MQ Service to add a user). 


In order to test this message flow, you will now add an MQ Input node and a File Output node so 


that the message flow can run in your environment. 
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In 


7. | Drag and drop an MQInput node (from the WebSphere MQ drawer) onto the canvas. 


the Properties, name the node SERVICE.TEST, set the input queue name to SERVICE.TEST 


(on the Basic tab) and the Inout Message Parsing to XMLNSC (on the Input Message Parsing 
tab). 





e Favorites 
ES WebSphere MQ 


‘DB MQHeader 


4d && Palette 


ix \o a = 









——| 
>| a -—_—_#——>a F——— 
“ie 


MQS_addEmployeeRR_MQHeader MQS addEmployeeRR_MQOutput MQ5_ addEmployeeRR. MQGet 





> MQOptimizedFlow... 


ums JMS 


iq Gr Problems | of Outline | ¥) Tasks FE Deployment Log} #5 Integration Registries 


ey > O) 


}> MQ Input Node Properties - SERVICE.TEST 


I 





“) Properties £3 \ (2. Problems| G= Outline | Tasks Deployment Log | % Integration Registries 
1 MQ Input Node Properties - SERVICE. TEST 
| Description ] 


Basic 


| Wi <MLINNSC : For AML messages (namespace aware, validation, low memory use 
Input Message Parsing | : = : F 
p Message model 





essage Parsing _ 


~ Parser Options 


Browse MQ Services... | 





Queue name" 


Parser Options 


| 
| 
| 
Advanced | 







—— 





Advanced | nea 
| Physical format 


8. Wire the Out terminal on the SERVICE.TEST MQ input node to the In terminal on the 
MQS_addEmployeeRR_MQHeader node. 
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as WebSphere MQ ~ 
(2) MQInput 


io, MQHeader 


Ve 


a. Favorites 








ie MQOptimizedFlow... 
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9. The default setting for the MQHeader node that is created by using the service is to add an MQ 
header. Change this setting to Carry forward header in the Properties (MQMD tab). 


il *addEmployee_CallIMQS.msgflow so = = 
4 <= Palette 
RA ES 
| Favorites | 
[ES WebSphereMQ | |a . 
)2 MQInput _)| SERVICE.TEST 
3] MQOutput = | = 
 MQReply oe ne 
ce —-@p___~ 


i) MQHeader | | MQS_addEmployeeRR_MQHeader J MQS_addEmployeeRR_MQOutput MQS_addEmployeeRR_MQGet 





























(if MQOptimizedFlow... . 
Gas JMS 
(a, HTTP 

Co Web Services 

(23, SCA 

(ge WebSphere Adapters 
s+ Routing 

Graph User Defined Properties 


= 


~~ Properties | i EE Problems| oe Outline | “4 Tasks FS Deployment Log 225 Integration Registries mS — 0) 


ra MQ Header Node Properties - MQS_ addEmployeeRR_MQHeader 








_ Description | Gy 
) MQMD header options Add header © Modify header © Delete header " 
| Coded Character Set Identifier 9 <Inhert from header> - 
MQDLH | 
Monitoring | Format <Inherit from header> ~| | Edit, 
Version Number <Inhernt from header> bea 
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__ 10. 
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Drag an MQHeader node onio the Canvas, dropping the node after the MQGet node. Rename 
the node to Remove MQ Header. Wire the Out terminal of the MQGet node called 
MQS_addEmployeeRR_MQGet (added automatically by using the service definition) to the In 
terminal of the Remove MQ Header node. In the Properties of the Header node, set Delete 
Header (on the MQMD tab). 





<* Palette 
Ds \ a * 
ICR Favorites 
| ES WebSphereMQ << ‘el ; 
Lee MQInput 
|] MQOutput = 
ry MQReply i —_ a 
ea +) i | ; ; fil : 4 
io, MQHeader . de R MQHeader MOQS_addEmployeeRR_MQOutput MQS_addEmployeeRR_MQGet ~ 


SERVICE.TEST 






i! MQOptimizedFlow... | ‘ O 

| Gas JMS Remove MQ Header 
‘(a HTTP 

o Web Services 

|. SCA 

| ‘gi WebSphere Adapters 
+ Routing 


[Properties fe: BY Problems = Outline 7 Tasks Ea] Deployment Log 25 Integration Registries a Oo | 


i MQ Header Node Properties - Remove MQ Header 





Description 

MQOMD header options Carry forward header Add header Modify header [}® Deeteheader_] 
F Report 

MQDLH 


Monitoring Format MOFMT_NONE 


mM 


Coded Character Set Identifier MOCCS!_ Q MGR 


Version Number MOMD VERSION 1 | =| 


Discovering what is new in IBM Integration Bus v9.0 


11. 


Drag and drop a FileOutput node (in the File drawer) onto the canvas to the right of the 


Remove MQ Header node. Name the node CallService.log. 


Wire the Out terminal of the Remove MQ Header to the In terminal on the CallService.log 
node. Also wire the Out terminal of the Remove MQ Header to the Finish terminal on the 


CallService.log node. 


In the Properties, on the Basic tab, set the Directory path to 


c:\student\service_discovery\data 
Set the File name or pattern to Callservice.log 


Select Stage in mqsitransit directory for file action 


a "addEmployee_CallMQS.msgflow 22: 


] <2 Palette 


Lg Construction 
p Database 
(& File 
3 Filelnput SERVICE.TEST 
ff) FileOutput 

Sh FileRead 







Es ‘erty 


()j FTEInput MQS_addEmployeeRR.MQHeader MQS_addEmployeeRR.MQQutput MQS_addEmployeeRR_MOGet Fp 


Al) FTEOutput 


3 CDinput 
eal) COOutput 
Loo Frriail ‘s 


Graph | User Defined Properties 





‘Properties ©) 9) (©) Problems| 5= Outline| 4) Tasks| Ei Deployment Log 4 Integration Registries 





i) File Output Node Properties - CallService.log 





Description 

Basic Directory c:\student\service_discovery\data 

Request Filename or pattern [Callservice.log 

Records and Elements File action 

Validation Mode for writing to file 

FTP Write directly to the output file (append if file exists) 

Monitoring @ Stage in masitransit directory and move to output directory on “Finish file? | 














Action if file exists | Replace Existing File 


Replace duplicate archive files 


__12. Save (CTRL-S) the message flow and close the message flow editor. 
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Remove MQ Header 


(CallServicelog 
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__ 13. 


9.6 


Deploy the ManageEmployee Application into the default Integration Server (drag the 
Application and drop it on the Integration Server). 


. P me re a oD : SS 
civboeicaton Dal, % Pattems Epic | 9” O 
| Sees” 

New. 





| Application Development 


« (A) ManageEmployee 

¥ Flows 

pul addEmployee_CallIMQS.msgflow 

pul addEmployee_ImplementMQS.msgflow 
©! ESQLs 

References 

BA seviceDefinitions 








| « (©) Independent Resources 


. |= BeneratedBarFiles 
Le TestClientBarFiles 








Test the Manage Employee application 


You are now ready to test the ManageEmployee application. 
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__1. Opena DB2 command line Processor window (Start — All Programs — IBM DB2 — 
DB2COPY1 — Command Line Tools — Command Line Processor). 


() Apple Software Update 
@ Internet Explorer (64-bit) 
@ Internet Explorer 
© Safari 
(GC) Windows Media Player 
F Windows Update 
a Accessories 
)) Android SDK Tools 
> Games 

Google Chrome 

IBM DB2 

). DB2COPY1 (Default) 


}, Command Line Tools 
[Es] Command Editor 
Command Line Processor Ph 


<3] Command Line Processor 
3] Command Window - Admin 
fe3) Command Window 
nT General Administration Tools 
). Information 


4 Back 
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Enter the commands: 


CONNECT TO SAMPLE 
SELECT * FROM EMPLOYEE WHERE EMPNO=200350 


If no record exists — good you will be able to add it. 


lf the record does exist, delete it using: 
DELETE FROM EMPLOYEE WHERE EMPNO=200350 


—_— —___— 


DB2 CLP - DB2COPY1 - C:\IBM\SQLUB\BIN\db2setcp.bat DB2SETCP.BAT DB2.EXE 


<c> Copyright IBM Corporation 1993,2607 
Command Line Processor for DB2 Client 9.7.3 


You can issue database manager commands and SQL statements from the command 
prompt. For example: 
db2 => connect to sample 


db2 => bind sample.bnd 


* general help. type: 7. 
* command help. type: 7? command, where command can be 
the first few keywords of a database manager command. For example: 
? CATALOG DATABASE for help on the CATALOG DATABASE command 
? CATALOG for help on all of the CATALOG commands. 


To exit db2 interactive mode, type QUIT at the command prompt. Outside 
minteractive mode, all commands must be prefixed with ’dhb2’. 
To list the current command option settings, type LIST COMMAND OPTIONS. 
For nore detailed help, refer to the Online Reference Manual. 
b2 => connect to sample 
Database Connection Information 
Database server = DB2/NT64 9.7.3 
SQL authorization ID = ADMIN 
Local database alias = SAMPLE 
db2 => select * from employee where empno=260350 
EMPNO FIRSTNME MIDINIT LASTNAME WORKDEPT PHONENO HIREDATE JOB 
EDLEVEL SEX BIRTHDATE SALARY BONUS COMM 


6 record¢s) selected. 





Keep this window open. 
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2. Drag file testAddManageEmployee.mbtest (using Windows Explorer) from 
C:\student\Service_discovery\resources onto the ManageEmployee Application in the IIB 
Toolkit. 




















Lea Application Develo 3 » EL, Patterns Explorer! = ——— occa _ 
& = =- es . — —_ —_—_—— es - E = 
| | > =) b « Local Disk (C:) » student » Servicediscovery > resources P| 
[EX] ManageEmployee || Organize |) Open New folder | -- © 
& Flows ib MessageMoc * ame ° Date modified Type Sate 
fal addEmployee_ CS.magilovw MessageSigh 
(ll addEmployee_Imphymenth4Q5.msgflow ~ Roe 3 |_| addEmployee.esq| 5/15/9013 10:52 AM = Text Document 1 KE 
ay ESOLs a - = i _. addEmployee_Compute.esql 6/0/13 209 PM Text Docurnent 2 KB 
I References Z — _) addEmployee_ImplementMQ5_Compute.. 6/16/2013 2:11PM Text Document 2KB 
' ay res 
BA pect na ee rr a : _) addEmployeel W_Compute.esql 6/14/20134:24 PM Text Document 2KB 
a rah Datinntons x i aiaatiasy _) addEmployee2W_Compute.esql 6/14/2013 4:56PM = Text Document 2KB 
E* ESQLs be erm : 
a anieee | y ae . Lb DEDemo_Ins_Upd_Ret_del_Pl 4/9/M13 331 PM Compressed (zpp.. 38 KB 
£) 0BS_employee.service hs Dy PHP i=) Employee 4/23/2013 11:26 AM = XMIL Document 1 KB 
Wl) MQS_addEmployeeRF service | " 2] Employee 6/15/2013 9:51PM XML Schema File 1 KB 
=, Other Resources " ci = Lb ManageEmployee_Stagel_Read 5/14/9013 1049 AM =Compressed (zipp.. 14 KE 
= re et e a |) ManageEmployee_Stage?_Read_Add SA1S/9013 5:34 PM = Compressed (zipp... 16 KB 
ic} bh SAPFi ; 
alae a Nccue _ [ih ManageEmployeeTests 6/10/2013 46 PM Compressed (zipp... 4 KB 
z os 7 |, readEmployee.esql 5/13/2013 3:55PM = Text Document 2 KE 
sequence 
oN |) RetrieveEmployee.mbtest 6/19/2013 5:30PM  MBTEST File 4 KB 
f ” Sent 
Ihe ———————— = | ce! P. am z P A nM Pe: : : 7 
‘an. eo - Sem |_| retrieveEmployee_ImplememtMQS.Com... 6/16/2013 5°06 PM = Text Docurnent 2 KE 
ta Integratio E2 Data Sourc %s. Data Proje | 4) Service_dishe ; 
Ho Integ WE Dota Sourc’ %: Data Proje “A city [i RetrieveEmployeeFiows 6/18/2013 4:44 PM Compressed (zipp.. 4KB 
z satel ii SAMPLE 5/2/2013 804 AM Compressed (zipp.. 7 KB 
insta 
| Test geEmployee.mbtest 6/19/2013 5:26PM MBTEST File 4KB 
Al IBSNODE )) resources 
(i Configurable Services | a workspace 
a default & setup = 
TestAddManageEmployee.mbtest Date modified: 6/19/2013 5:26 PM Date created: 7/30/2013 6:36 PM 
| METEST File Sire: 3.64 KB 


3. Open the testAddManageEmployee.mbtest file by double clicking on it. It will be in the 
ManageEmployee—Flow Tests folder. The saved Test Client window will open. 


Fa, Application Develo a 8, Pattems Explorer mi) 
cee” Events 








Application Development New. | 
1 Select the message flow you would lie to test. Click Send Message to run. 
a oe Message Flow Test Events General Properties 
[Ml addEmployee_CallMQS.msgfiow rale ee elner + Detailed Properties 
ee 2s aaa ET Invoke Message Flow ay Message flow: | /ManageEmployee/addEmployee_CallQ5.msgflow 
Te Inputmode:  SERVICE.TEST 


Message 
} Header 





= oy: [Edit as text 


(A. Schema Definitions 
» Ge ESQLs 


a (2% Services 


€?aml versiqon="1.0" encoding="U0TF=-8"?> 
S<tnsiEmployes mlns:tns="Attp: s/w. serviceDisce. con/Eaploys 


» £) DBS_employeeservice <Empio>2)0350<¢/Expiio> 
» gl) MQS_addEmployeeRR service <FiracNane>Buge</Firsthame> 
al") Other Resources <Initialsa</Initial> 
* Igy SAMPLE <Lastham=>Bunny</ Lasthame> 
~ [Bj Independent Resources <DeptoE2i</Dept> 
<Fhone>6650¢/Fhone> 
SS —— ——— {Jobs FIELDREP</ Jck> 
Sa Integratio 12 WRG Data Source) %5. Data Proje |“ | <EdLevel>14</EdLevel> 
a fl | tSexrHe (Sex> 








dig Integration Modes 
Al IBSNODE 
i Configurable Services 
a. default 











| Ewents | Configuration | 
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4. Onclicking Send Message, the XML message that is displayed will be sent to the 
SERVICE.TEST queue. The message will be picked up by the addEmployee_CallMQS 
message flow and written to the SERVICE.DISCOVERY.DB.ADD.IN queue. The message flow 
addEmployee_ImplementMQ$ will pick this request up and add the user with EMPNO=200350 
to the database using the ESQL provided by implementing the Database Service 
DBS_ employee and using the createEmployee procedure created by adding the INSERT 
operation in the service. 


The results will be written to the file CallService.log in C:\student\service_discovery\data 
Click Send Message. 


le) TestAddManageEmployee © ar! 





Events 
i 4 
Message Flow Test Events ) General Properties 
> b#P\/ fer + Detailed Properties 
IEF Invoke Message Flow Message flow: | /ManageEmployee/addEmployee_CallMQS.msgflow = 
Inputnode: | SERVICE.TEST « 
Message 


» Header 
Body: | Edit as text . 


<?xml version="1.0" encoding="0TF-8"?> * 
- 


= 
pi//vev.serviceDisco. com/Employe 


=o ae be Tomar : ¥ | ie 
<tHs: Employee AMInS: ths" AC 


a5 fo 


a ee 
<Emplio>200350</ Empio> 


@ Lu bh 


Import Source... 


Events | Configuration 
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__5. — Select the default Integration Server and click Next. 


STEEEEIEE Enna 





(D) Select Deployment Location 


Specify deployment details 


This server instance is currently running. 


Deployment location: 


4 & Integration Bus v9.0 New Local Integration Node... 


4 & IBONODE | 
¢. default Connect to Remote Integration Node... 


|_| Trace and debug 
__| Stop at the beginning of the flow during debugging 
Always use the same deployment location for every test run 





Specify Test Settings 


Determine the settings of the test environment. 


Seconds to wait for deployment completion 20 
Seconds to wait after Test Client complete the deployment 0 











Seconds to wait on launching the debugger for tracing purpose 20 

Show information dialog before disconnecting debugger. 

Seconds to wait for test client to stop 

Create queues of input and output nodes of message flows when host name is localhost 
Add or modify (but not clear) what has already been deployed on the execution group 
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7. Wait for the deployment to complete, and then the 30 seconds for the test client to stop (the 
output of the message flow being tested is a file, so the test client does not end automatically 
when the file is written; therefore, we are waiting for the test client to time out the set number of 
seconds). 


8. Go back to the DB2 Command Line Processor window and enter: 
SELECT * FROM EMPLOYEE WHERE EMPNO=200350 


9. The select should retrieve the newly inserted record, with the EMPNO=200350. 


| DB2 CLP - DB2COPY1 - C\IBM\SQLLIB\BIN\db2setcp.bat DB2SETCP.BAT DB2.EXE 
db2 => select * from employee where empno=266356 


EMPNO FIRSTNME MIDINIT LASTNAME WORKDEPT PHONENO HIREDATE JOB 
SALARY BONUS COMM 


@ record(s) selected. 
ib2 => select * from employee where empno=200356 


EMPNO FIRSTNME MIDINIT LASTNAME WORKDEPT PHONENO HIREDATE JOB 
EDLEVEL SEX BIRTHDATE SALARY BONUS COMM 


2606350 Bugs R 6656 05713/2613 FIELDREP 
a 11/17/1959 156.06 166.66 246.46 


1 record¢s> selected. 


dlb2 => 





__10. Inthe DB2 Command Line Processor window, enter quit to exit the DB2 command line, and 
then enter exit to close the Command Line window. 





"BB Administrator: DB2 CLP - DB2COPY1 


0 rvecord¢s) selected. 
db2 => select * from employee where empno=2680356 
EMPNO FIRSTNME MIDINIT LASTNAME 


Bunny 05713726013 FIELDREP 
1546.66 168.66 26.88 


uit 
Tie QUI Gesemmeand completed successfully. 
iC:\ IT BM\SGLLIBN\BIN>exit _ 
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IZ: 


__ 13. 
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11. 


Now in Windows Explorer, move to the C:\student\Service_discovery\data directory. You should 
find the file named CallService.log ew created by the palace flow. 


di MessageMoc * Name 


)) MessageSigh 
= 
J) MQ71-Lab 
Ls matt 
) MQTTsampk 
J pattern 
). PatternAuth 
|). PHP 
bi ps 
a RecordRepla, 
). SAPFiles | 
Jy SECUR 
ad sequence 
ad Service_creat — 
) ad Service_disco 
)) data 
install 
a resources 
_L. workspace 
J) setup 


Jy 2WCallService 

_)) masitransit 

=) add_employee200350 
le 


[=] Laat 
(=) retieveEmployee200350 
_| RetrieveCallService 


Size: 554 bytes 


| Callservice Date modified: 12/12/2013 3:16 PM 
| Text Document 


<?xml versione" io" encoding=" UTF-8"? 

|<tns Emp 
dries e: 350</EmpNo> 

| <FirstName>6bugs</FirstName> 
<Initial>R</Initial> 
<LastName>Bunny</LastName> 
<Dept>E21</Dept> 
<Phone>6650</Phone> 

| <Job>FIELDREP</Job> 
<EdLeve|l>14</EdLevel> 

<Sex>mM</5ex> 

<Salary>150. 00</Salary> 

<Bonus>100. 00</Bonus> 

<Commission>20.00</Commission> 

|</tns :Employee> 





Close Notepad. 


ee xmins:tns="http: //www. servicentscn, com/Employee" xmins:xsi="http: //www. w3. 


Date modified 
7/30/2013 6:36 PM File folder 
12/12/2013 3:16PM File folder 


6/14/2013 2:24 PM XML Document 
6/16/2013 2:43 PM XML Document 


12/12/2013 3:16PM TextDocument = = IKB 


5/15/2013 11:47 AM XML Document 
4/23/2013 11:26 AM XML Document 
6/18/2013 9:50 AM XML Document 
6/16/2013 9:24 PM Text Document 


Date created: 12/12/2013 3:16 PM 





org,/2001/xmMLSchema-instance" xsi:s r 
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__ 14. Back in the IIB Toolkit, close the test client file (click on the X). Select No to not save the 


changes. 
iz “TestaddManageEmployeffee 
Events 
Message Flow Test Events » General Properties 


> ele Sf Fl BSR 
IEF Invoke Message Flow 
Message flows deployment successfully completed 


. 
“Teeter 


| © Detailed Properties 





Host: localhost 


Port: 0 






Show in hexadecimal viewer (Read On ly) 


te | i - i) Au th hire APs 


This concludes the Service Discovery lab. 


This is the end of Lab 5. 
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Appendix A. Notices 
This information was developed for products and services offered in the U.S.A. 


IBM may not offer the products, services, or features discussed in this document in other countries. 
Consult your local IBM representative for information on the products and services currently available in 
your area. Any reference to an IBM product, program, or service is not intended to state or imply that 
only that IBM product, program, or service may be used. Any functionally equivalent product, program, or 
service that does not infringe any IBM intellectual property right may be used instead. However, it is the 
user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter described in this 
document. The furnishing of this document does not grant you any license to these patents. You can 
send license inquiries, in writing, to: 


IBM Director of Licensing 
IBM Corporation 

North Castle Drive 
Armonk, NY 10504-1785 
U.S.A. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property 
Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106-0032, Japan 


The following paragraph does not apply to the United Kingdom or any other country where such 
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES 
CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, 
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some 
states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this 
statement may not apply to you. 


This information could include technical inaccuracies or typographical errors. Changes are periodically 
made to the information herein; these changes will be incorporated in new editions of the publication. 
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this 
publication at any time without notice. 


Any references in this information to non-IBM Web sites are provided for convenience only and do not in 
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part 
of the materials for this IBM product and use of those Web sites is at your own risk. 


IBM may use or distribute any of the information you supply in any way it believes appropriate without 
incurring any obligation to you. 


Any performance data contained herein was determined in a controlled environment. Therefore, the 
results obtained in other operating environments may vary significantly. Some measurements may have 
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been made on development-level systems and there is no guarantee that these measurements will be 
the same on generally available systems. Furthermore, some measurements may have been estimated 
through extrapolation. Actual results may vary. Users of this document should verify the applicable data 
for their specific environment. 


Information concerning non-IBM products was obtained from the suppliers of those products, their 
published announcements or other publicly available sources. IBM has not tested those products and 
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM 
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of 
those products. 


All statements regarding IBM's future direction and intent are subject to change or withdrawal without 
notice, and represent goals and objectives only. 


(This information contains examples of data and reports used in daily business operations. To illustrate 
them as completely as possible, the examples include the names of individuals, companies, brands, and 
products. All of these names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. All references to fictitious companies or individuals are 
used for illustration purposes only. 


COPYRIGHT LICENSE: 


This information contains sample application programs in source language, which illustrate programming 
techniques on various operating platforms. You may copy, modify, and distribute these sample programs 
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing 
application programs conforming to the application programming interface for the operating platform for 
which the sample programs are written. These examples have not been thoroughly tested under all 
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these 
programs. 
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Appendix B. Trademarks and copyrights 


The following terms are trademarks of International Business Machines Corporation in the United States, 
other countries, or both: 


IBM AIX CICS ClearCase ClearQuest Cloudscape 
Cube Views DB2 developerWorks DRDA IMS IMS/ESA 
Informix Lotus Lotus Workflow MQSeries OmniFind 

Rational Redbooks Red Brick RequisitePro System | 

System z Tivoli WebSphere Workplace System p 


Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or 
trademarks of Adobe Systems Incorporated in the United States, and/or other countries. 


IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications 
Agency which is now part of the Office of Government Commerce. 


Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel 
SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its 
subsidiaries in the United States and other countries. 

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. 


Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the 
United States, other countries, or both. 


ITIL is a registered trademark, and a registered community trademark of The Minister for the Cabinet 
Office, and is registered in the U.S. Patent and Trademark Office. 


UNIX is a registered trademark of The Open Group in the United States and other countries. 


Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or 
its affiliates. 


Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other 
countries, or both and is used under license therefrom. 


Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo are trademarks of HP, IBM Corp. 
and Quantum in the U.S. and other countries. 
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